/ Developer CD Series 1993…ch: Other People's Memory / ADC Developer CD (1993-03) (''Other People's Memory'')_iso / Dev.CD Mar 93.iso / Technical Documentation / Mac Tech Notes (DocViewer) / TN-Platforms & Tools

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 14 54 4e 2d 50 6c 61 | 74 66 6f 72 6d 73 20 26 |..TN-Pla|tforms &|
|00000010| 20 54 6f 6f 6c 73 00 00 | 00 00 00 00 00 00 00 00 | Tools..|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 2a 36 41 00 | 01 3d 15 a7 5c f9 08 a7 |....*6A.|.=..\...|
|00000060| 6f 54 0e 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |oT......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 7c 73 00 00 |........|....|s..|
|00000080| 27 63 6b 69 64 27 20 52 | 65 73 6f 75 72 63 65 20 |'ckid' R|esource |
|00000090| 46 6f 72 6d 61 74 0d 50 | 6c 61 74 66 6f 72 6d 73 |Format.P|latforms|
|000000a0| 20 26 20 54 6f 6f 6c 73 | 09 4d 2e 50 54 2e 50 72 | & Tools|.M.PT.Pr|
|000000b0| 6f 6a 65 63 74 6f 72 52 | 65 73 6f 75 72 63 65 0d |ojectorR|esource.|
|000000c0| 57 72 69 74 74 65 6e 20 | 62 79 3a 09 4b 65 69 74 |Written |by:.Keit|
|000000d0| 68 20 52 6f 6c 6c 69 6e | 09 41 70 72 69 6c 20 31 |h Rollin|.April 1|
|000000e0| 39 39 30 0d 54 68 69 73 | 20 54 65 63 68 6e 69 63 |990.This| Technic|
|000000f0| 61 6c 20 4e 6f 74 65 20 | 64 65 73 63 72 69 62 65 |al Note |describe|
|00000100| 73 20 74 68 65 20 27 63 | 6b 69 64 27 20 72 65 73 |s the 'c|kid' res|
|00000110| 6f 75 72 63 65 20 66 6f | 72 6d 61 74 20 75 73 65 |ource fo|rmat use|
|00000120| 64 20 62 79 20 4d 50 57 | d5 73 20 50 72 6f 6a 65 |d by MPW|.s Proje|
|00000130| 63 74 6f 72 2e 20 20 49 | 66 20 79 6f 75 20 61 72 |ctor.  I|f you ar|
|00000140| 65 20 77 72 69 74 69 6e | 67 20 61 6e 20 65 64 69 |e writin|g an edi|
|00000150| 74 6f 72 20 6f 72 20 64 | 65 76 65 6c 6f 70 6d 65 |tor or d|evelopme|
|00000160| 6e 74 20 73 79 73 74 65 | 6d 2c 20 79 6f 75 20 6d |nt syste|m, you m|
|00000170| 61 79 20 77 69 73 68 20 | 74 6f 20 61 6c 6c 6f 77 |ay wish |to allow|
|00000180| 20 6f 72 20 64 69 73 61 | 6c 6c 6f 77 20 66 69 6c | or disa|llow fil|
|00000190| 65 20 6d 6f 64 69 66 69 | 63 61 74 69 6f 6e 20 62 |e modifi|cation b|
|000001a0| 61 73 65 64 20 6f 6e 20 | 74 68 65 20 69 6e 66 6f |ased on |the info|
|000001b0| 72 6d 61 74 69 6f 6e 20 | 69 6e 20 74 68 65 20 72 |rmation |in the r|
|000001c0| 65 73 6f 75 72 63 65 2e | 0d 4d 50 57 20 33 2e 30 |esource.|.MPW 3.0|
|000001d0| 20 61 6e 64 20 67 72 65 | 61 74 65 72 20 69 6d 70 | and gre|ater imp|
|000001e0| 6c 65 6d 65 6e 74 20 61 | 20 73 6f 75 72 63 65 20 |lement a| source |
|000001f0| 63 6f 64 65 20 63 6f 6e | 74 72 6f 6c 20 73 79 73 |code con|trol sys|
|00000200| 74 65 6d 20 63 61 6c 6c | 65 64 20 50 72 6f 6a 65 |tem call|ed Proje|
|00000210| 63 74 6f 72 2e 20 20 50 | 72 6f 6a 65 63 74 6f 72 |ctor.  P|rojector|
|00000220| 20 6d 61 6e 61 67 65 73 | 20 73 65 74 73 20 6f 66 | manages| sets of|
|00000230| 20 73 6f 75 72 63 65 20 | 63 6f 64 65 20 66 69 6c | source |code fil|
|00000240| 65 73 20 6b 6e 6f 77 6e | 20 61 73 20 70 72 6f 6a |es known| as proj|
|00000250| 65 63 74 73 2e 20 20 55 | 73 65 72 73 20 61 72 65 |ects.  U|sers are|
|00000260| 20 61 62 6c 65 20 74 6f | 20 63 68 65 63 6b 20 6f | able to| check o|
|00000270| 75 74 20 73 6f 75 72 63 | 65 20 63 6f 64 65 2c 20 |ut sourc|e code, |
|00000280| 6d 61 6b 65 20 6d 6f 64 | 69 66 69 63 61 74 69 6f |make mod|ificatio|
|00000290| 6e 73 20 74 6f 20 69 74 | 2c 20 61 6e 64 20 63 68 |ns to it|, and ch|
|000002a0| 65 63 6b 20 69 74 20 62 | 61 63 6b 20 69 6e 74 6f |eck it b|ack into|
|000002b0| 20 74 68 65 20 70 72 6f | 6a 65 63 74 2e 20 20 53 | the pro|ject.  S|
|000002c0| 6f 75 72 63 65 20 63 6f | 64 65 20 63 61 6e 20 62 |ource co|de can b|
|000002d0| 65 20 63 68 65 63 6b 65 | 64 20 6f 75 74 20 61 73 |e checke|d out as|
|000002e0| 20 d2 6d 6f 64 69 66 69 | 61 62 6c 65 d3 20 6f 72 | .modifi|able. or|
|000002f0| 20 d2 72 65 61 64 2d 6f | 6e 6c 79 2e d3 20 20 4f | .read-o|nly..  O|
|00000300| 6e 6c 79 20 6f 6e 65 20 | 6d 6f 64 69 66 69 61 62 |nly one |modifiab|
|00000310| 6c 65 20 76 65 72 73 69 | 6f 6e 20 6f 66 20 61 20 |le versi|on of a |
|00000320| 73 6f 75 72 63 65 20 66 | 69 6c 65 20 69 73 20 61 |source f|ile is a|
|00000330| 6c 6c 6f 77 65 64 20 74 | 6f 20 62 65 20 63 68 65 |llowed t|o be che|
|00000340| 63 6b 65 64 20 6f 75 74 | 20 61 74 20 61 20 74 69 |cked out| at a ti|
|00000350| 6d 65 2e 20 20 54 68 69 | 73 20 66 65 61 74 75 72 |me.  Thi|s featur|
|00000360| 65 20 69 73 20 76 65 72 | 79 20 75 73 65 66 75 6c |e is ver|y useful|
|00000370| 20 69 66 20 79 6f 75 20 | 73 74 6f 72 65 20 79 6f | if you |store yo|
|00000380| 75 72 20 66 69 6c 65 73 | 20 6f 6e 20 61 20 73 65 |ur files| on a se|
|00000390| 72 76 65 72 20 73 75 63 | 68 20 61 73 20 41 70 70 |rver suc|h as App|
|000003a0| 6c 65 53 68 61 72 65 3b | 20 61 6e 79 6f 6e 65 20 |leShare;| anyone |
|000003b0| 65 6c 73 65 20 74 72 79 | 69 6e 67 20 74 6f 20 63 |else try|ing to c|
|000003c0| 68 65 63 6b 20 6f 75 74 | 20 74 68 65 20 73 61 6d |heck out| the sam|
|000003d0| 65 20 66 69 6c 65 20 63 | 61 6e 20 6f 6e 6c 79 20 |e file c|an only |
|000003e0| 63 68 65 63 6b 20 69 74 | 20 6f 75 74 20 d2 72 65 |check it| out .re|
|000003f0| 61 64 2d 6f 6e 6c 79 2c | d3 20 65 6e 73 75 72 69 |ad-only,|. ensuri|
|00000400| 6e 67 20 74 68 61 74 20 | 74 77 6f 20 70 65 6f 70 |ng that |two peop|
|00000410| 6c 65 20 61 72 65 20 6e | 6f 74 20 6d 6f 64 69 66 |le are n|ot modif|
|00000420| 79 69 6e 67 20 74 68 65 | 20 73 61 6d 65 20 66 69 |ying the| same fi|
|00000430| 6c 65 20 61 74 20 74 68 | 65 20 73 61 6d 65 20 74 |le at th|e same t|
|00000440| 69 6d 65 2e 0d 4e 6f 74 | 65 3a 09 54 68 69 73 20 |ime..Not|e:.This |
|00000450| 69 73 20 61 6e 20 6f 76 | 65 72 6c 79 20 73 69 6d |is an ov|erly sim|
|00000460| 70 6c 69 73 74 69 63 20 | 64 65 73 63 72 69 70 74 |plistic |descript|
|00000470| 69 6f 6e 20 6f 66 20 50 | 72 6f 6a 65 63 74 6f 72 |ion of P|rojector|
|00000480| 2e 20 20 49 74 20 63 61 | 6e 20 61 63 74 75 61 6c |.  It ca|n actual|
|00000490| 6c 79 20 6d 61 6e 61 67 | 65 20 6d 6f 72 65 20 74 |ly manag|e more t|
|000004a0| 68 61 6e 20 6a 75 73 74 | 20 73 6f 75 72 63 65 20 |han just| source |
|000004b0| 63 6f 64 65 20 61 6e 64 | 20 68 61 73 20 70 72 6f |code and| has pro|
|000004c0| 76 69 73 69 6f 6e 73 20 | 66 6f 72 20 76 61 72 69 |visions |for vari|
|000004d0| 61 74 69 6f 6e 73 20 6f | 6e 20 74 68 65 20 6d 6f |ations o|n the mo|
|000004e0| 64 69 66 69 61 62 6c 65 | 20 6f 72 20 72 65 61 64 |difiable| or read|
|000004f0| 2d 6f 6e 6c 79 20 73 63 | 68 65 6d 65 2c 20 73 75 |-only sc|heme, su|
|00000500| 63 68 20 61 73 20 62 65 | 69 6e 67 20 61 62 6c 65 |ch as be|ing able|
|00000510| 20 74 6f 20 63 72 65 61 | 74 65 20 65 78 70 65 72 | to crea|te exper|
|00000520| 69 6d 65 6e 74 61 6c 20 | 6f 66 66 73 68 6f 6f 74 |imental |offshoot|
|00000530| 73 20 6f 66 20 74 68 65 | 20 6d 61 69 6e 20 73 6f |s of the| main so|
|00000540| 75 72 63 65 20 63 6f 64 | 65 20 63 61 6c 6c 65 64 |urce cod|e called|
|00000550| 20 62 72 61 6e 63 68 65 | 73 2e 0d 4d 50 57 20 61 | branche|s..MPW a|
|00000560| 74 74 61 63 68 65 73 20 | 50 72 6f 6a 65 63 74 6f |ttaches |Projecto|
|00000570| 72 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 74 6f |r inform|ation to|
|00000580| 20 63 68 65 63 6b 65 64 | 20 6f 75 74 20 66 69 6c | checked| out fil|
|00000590| 65 73 20 62 79 20 61 64 | 64 69 6e 67 20 27 63 6b |es by ad|ding 'ck|
|000005a0| 69 64 27 20 72 65 73 6f | 75 72 63 65 73 20 74 6f |id' reso|urces to|
|000005b0| 20 74 68 65 6d 2e 20 20 | 54 68 69 73 20 72 65 73 | them.  |This res|
|000005c0| 6f 75 72 63 65 20 63 6f | 6e 74 61 69 6e 73 20 69 |ource co|ntains i|
|000005d0| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 73 75 63 68 20 |nformati|on such |
|000005e0| 61 73 20 74 6f 20 77 68 | 61 74 20 70 72 6f 6a 65 |as to wh|at proje|
|000005f0| 63 74 20 74 68 65 20 66 | 69 6c 65 20 69 73 20 61 |ct the f|ile is a|
|00000600| 74 74 61 63 68 65 64 2c | 20 77 68 65 6e 20 74 68 |ttached,| when th|
|00000610| 65 20 66 69 6c 65 20 77 | 61 73 20 63 68 65 63 6b |e file w|as check|
|00000620| 65 64 20 6f 75 74 2c 20 | 77 68 6f 20 63 68 65 63 |ed out, |who chec|
|00000630| 6b 65 64 20 69 74 20 6f | 75 74 2c 20 61 6e 64 20 |ked it o|ut, and |
|00000640| 77 68 65 74 68 65 72 20 | 6f 72 20 6e 6f 74 20 69 |whether |or not i|
|00000650| 74 20 77 61 73 20 63 68 | 65 63 6b 65 64 20 6f 75 |t was ch|ecked ou|
|00000660| 74 20 72 65 61 64 2d 6f | 6e 6c 79 2e 20 20 49 66 |t read-o|nly.  If|
|00000670| 20 69 74 20 69 73 20 63 | 68 65 63 6b 65 64 20 6f | it is c|hecked o|
|00000680| 75 74 20 72 65 61 64 2d | 6f 6e 6c 79 2c 20 74 68 |ut read-|only, th|
|00000690| 65 20 4d 50 57 20 53 68 | 65 6c 6c 20 74 61 6b 65 |e MPW Sh|ell take|
|000006a0| 73 20 6e 6f 74 65 20 6f | 66 20 74 68 69 73 2c 20 |s note o|f this, |
|000006b0| 61 6e 64 20 64 6f 65 73 | 20 6e 6f 74 20 61 6c 6c |and does| not all|
|000006c0| 6f 77 20 74 68 65 20 75 | 73 65 72 20 74 6f 20 65 |ow the u|ser to e|
|000006d0| 64 69 74 20 74 68 65 20 | 66 69 6c 65 2e 0d 49 66 |dit the |file..If|
|000006e0| 20 79 6f 75 20 61 72 65 | 20 77 6f 72 6b 69 6e 67 | you are| working|
|000006f0| 20 6f 6e 20 61 20 64 65 | 76 65 6c 6f 70 6d 65 6e | on a de|velopmen|
|00000700| 74 20 6f 72 20 73 6f 75 | 72 63 65 20 63 6f 64 65 |t or sou|rce code|
|00000710| 20 65 64 69 74 69 6e 67 | 20 73 79 73 74 65 6d 2c | editing| system,|
|00000720| 20 74 68 65 6e 20 79 6f | 75 20 6d 61 79 20 77 69 | then yo|u may wi|
|00000730| 73 68 20 74 6f 20 72 65 | 73 70 65 63 74 20 74 68 |sh to re|spect th|
|00000740| 65 20 27 63 6b 69 64 27 | 20 72 65 73 6f 75 72 63 |e 'ckid'| resourc|
|00000750| 65 2e 20 20 41 74 20 74 | 68 65 20 76 65 72 79 20 |e.  At t|he very |
|00000760| 6c 65 61 73 74 2c 20 74 | 68 69 73 20 6d 65 61 6e |least, t|his mean|
|00000770| 73 20 6e 6f 74 20 64 65 | 6c 65 74 69 6e 67 20 69 |s not de|leting i|
|00000780| 74 2e 20 20 57 68 65 6e | 20 73 61 76 69 6e 67 20 |t.  When| saving |
|00000790| 63 68 61 6e 67 65 73 20 | 74 6f 20 61 6e 20 65 78 |changes |to an ex|
|000007a0| 69 73 74 69 6e 67 20 66 | 69 6c 65 2c 20 73 6f 6d |isting f|ile, som|
|000007b0| 65 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 73 20 77 |e applic|ations w|
|000007c0| 72 69 74 65 20 74 68 65 | 20 6d 6f 64 69 66 69 65 |rite the| modifie|
|000007d0| 64 20 64 61 74 61 20 74 | 6f 20 61 20 74 65 6d 70 |d data t|o a temp|
|000007e0| 6f 72 61 72 79 20 66 69 | 6c 65 2c 20 64 65 6c 65 |orary fi|le, dele|
|000007f0| 74 65 20 74 68 65 20 6f | 6c 64 20 66 69 6c 65 2c |te the o|ld file,|
|00000800| 20 61 6e 64 20 72 65 6e | 61 6d 65 20 74 68 65 20 | and ren|ame the |
|00000810| 74 65 6d 70 6f 72 61 72 | 79 20 66 69 6c 65 20 74 |temporar|y file t|
|00000820| 6f 20 68 61 76 65 20 74 | 68 65 20 73 61 6d 65 20 |o have t|he same |
|00000830| 6e 61 6d 65 20 61 73 20 | 74 68 65 20 6f 72 69 67 |name as |the orig|
|00000840| 69 6e 61 6c 2e 20 20 55 | 6e 66 6f 72 74 75 6e 61 |inal.  U|nfortuna|
|00000850| 74 65 6c 79 2c 20 74 68 | 69 73 20 64 65 6c 65 74 |tely, th|is delet|
|00000860| 65 73 20 74 68 65 20 27 | 63 6b 69 64 27 20 72 65 |es the '|ckid' re|
|00000870| 73 6f 75 72 63 65 2c 20 | 70 72 65 76 65 6e 74 69 |source, |preventi|
|00000880| 6e 67 20 74 68 65 20 75 | 73 65 72 20 66 72 6f 6d |ng the u|ser from|
|00000890| 20 63 68 65 63 6b 69 6e | 67 20 74 68 65 69 72 20 | checkin|g their |
|000008a0| 66 69 6c 65 20 62 61 63 | 6b 20 69 6e 74 6f 20 74 |file bac|k into t|
|000008b0| 68 65 20 50 72 6f 6a 65 | 63 74 6f 72 20 64 61 74 |he Proje|ctor dat|
|000008c0| 61 62 61 73 65 2e 20 20 | 41 70 70 6c 69 63 61 74 |abase.  |Applicat|
|000008d0| 69 6f 6e 73 20 73 61 76 | 69 6e 67 20 66 69 6c 65 |ions sav|ing file|
|000008e0| 73 20 77 69 74 68 20 74 | 68 69 73 20 74 65 63 68 |s with t|his tech|
|000008f0| 6e 69 71 75 65 20 73 68 | 6f 75 6c 64 20 74 72 61 |nique sh|ould tra|
|00000900| 6e 73 66 65 72 20 74 68 | 65 20 72 65 73 6f 75 72 |nsfer th|e resour|
|00000910| 63 65 20 6f 76 65 72 20 | 62 65 66 6f 72 65 20 64 |ce over |before d|
|00000920| 65 6c 65 74 69 6e 67 20 | 74 68 65 20 6f 6c 64 20 |eleting |the old |
|00000930| 66 69 6c 65 2e 0d 49 66 | 20 79 6f 75 20 77 61 6e |file..If| you wan|
|00000940| 74 20 74 6f 20 69 6e 63 | 6c 75 64 65 20 6d 6f 72 |t to inc|lude mor|
|00000950| 65 20 73 75 70 70 6f 72 | 74 20 66 6f 72 20 74 68 |e suppor|t for th|
|00000960| 65 20 72 65 73 6f 75 72 | 63 65 2c 20 79 6f 75 20 |e resour|ce, you |
|00000970| 63 6f 75 6c 64 20 70 72 | 65 76 65 6e 74 20 74 68 |could pr|event th|
|00000980| 65 20 75 73 65 72 20 66 | 72 6f 6d 20 6d 61 6b 69 |e user f|rom maki|
|00000990| 6e 67 20 63 68 61 6e 67 | 65 73 20 69 66 20 74 68 |ng chang|es if th|
|000009a0| 65 20 66 69 6c 65 20 69 | 73 20 63 68 65 63 6b 65 |e file i|s checke|
|000009b0| 64 20 6f 75 74 20 72 65 | 61 64 2d 6f 6e 6c 79 2e |d out re|ad-only.|
|000009c0| 20 20 54 68 69 73 20 63 | 61 6e 20 62 65 20 64 6f |  This c|an be do|
|000009d0| 6e 65 20 62 79 20 72 65 | 61 64 69 6e 67 20 74 68 |ne by re|ading th|
|000009e0| 65 20 27 63 6b 69 64 27 | 20 72 65 73 6f 75 72 63 |e 'ckid'| resourc|
|000009f0| 65 20 61 6e 64 20 6c 6f | 6f 6b 69 6e 67 20 61 74 |e and lo|oking at|
|00000a00| 20 74 68 65 20 61 70 70 | 72 6f 70 72 69 61 74 65 | the app|ropriate|
|00000a10| 20 66 69 65 6c 64 73 2e | 20 20 54 68 65 20 65 6e | fields.|  The en|
|00000a20| 74 69 72 65 20 66 6f 72 | 6d 61 74 20 6f 66 20 74 |tire for|mat of t|
|00000a30| 68 65 20 27 63 6b 69 64 | 27 20 72 65 73 6f 75 72 |he 'ckid|' resour|
|00000a40| 63 65 20 69 73 20 61 70 | 70 65 6e 64 65 64 20 74 |ce is ap|pended t|
|00000a50| 6f 20 74 68 65 20 65 6e | 64 20 6f 66 20 74 68 69 |o the en|d of thi|
|00000a60| 73 20 4e 6f 74 65 2e 20 | 20 59 6f 75 20 73 68 6f |s Note. | You sho|
|00000a70| 75 6c 64 20 62 65 20 69 | 6e 74 65 72 65 73 74 65 |uld be i|ntereste|
|00000a80| 64 20 69 6e 20 6f 6e 6c | 79 20 66 6f 75 72 20 66 |d in onl|y four f|
|00000a90| 69 65 6c 64 73 20 6f 66 | 20 74 68 65 20 72 65 73 |ields of| the res|
|00000aa0| 6f 75 72 63 65 3a 0d 76 | 65 72 73 69 6f 6e 09 54 |ource:.v|ersion.T|
|00000ab0| 68 69 73 20 74 77 6f 2d | 62 79 74 65 20 66 69 65 |his two-|byte fie|
|00000ac0| 6c 64 20 68 6f 6c 64 73 | 20 74 68 65 20 76 65 72 |ld holds| the ver|
|00000ad0| 73 69 6f 6e 20 6e 75 6d | 62 65 72 20 6f 66 20 74 |sion num|ber of t|
|00000ae0| 68 65 20 27 63 6b 69 64 | 27 20 72 65 73 6f 75 72 |he 'ckid|' resour|
|00000af0| 63 65 2e 20 20 54 68 65 | 20 63 75 72 72 65 6e 74 |ce.  The| current|
|00000b00| 20 76 65 72 73 69 6f 6e | 20 6e 75 6d 62 65 72 20 | version| number |
|00000b10| 69 73 20 34 2e 20 20 54 | 68 65 20 69 6e 66 6f 72 |is 4.  T|he infor|
|00000b20| 6d 61 74 69 6f 6e 20 70 | 72 65 73 65 6e 74 65 64 |mation p|resented|
|00000b30| 20 69 6e 20 74 68 69 73 | 20 4e 6f 74 65 20 69 73 | in this| Note is|
|00000b40| 20 76 61 6c 69 64 20 66 | 6f 72 20 74 68 69 73 20 | valid f|or this |
|00000b50| 76 65 72 73 69 6f 6e 20 | 6e 75 6d 62 65 72 20 6f |version |number o|
|00000b60| 6e 6c 79 2e 20 20 41 6e | 79 20 61 74 74 65 6d 70 |nly.  An|y attemp|
|00000b70| 74 20 74 6f 20 61 70 70 | 6c 79 20 74 68 65 20 69 |t to app|ly the i|
|00000b80| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 70 72 65 73 65 |nformati|on prese|
|00000b90| 6e 74 65 64 20 68 65 72 | 65 20 74 6f 20 61 20 27 |nted her|e to a '|
|00000ba0| 63 6b 69 64 27 20 72 65 | 73 6f 75 72 63 65 20 77 |ckid' re|source w|
|00000bb0| 69 74 68 20 61 20 64 69 | 66 66 65 72 65 6e 74 20 |ith a di|fferent |
|00000bc0| 76 65 72 73 69 6f 6e 20 | 77 6f 75 6c 64 20 62 65 |version |would be|
|00000bd0| 20 62 61 64 2e 0d 63 68 | 65 63 6b 53 75 6d 09 54 | bad..ch|eckSum.T|
|00000be0| 68 69 73 20 66 6f 75 72 | 2d 62 79 74 65 20 66 69 |his four|-byte fi|
|00000bf0| 65 6c 64 20 68 6f 6c 64 | 73 20 61 20 63 68 65 63 |eld hold|s a chec|
|00000c00| 6b 73 75 6d 20 74 6f 20 | 76 61 6c 69 64 61 74 65 |ksum to |validate|
|00000c10| 20 74 68 65 20 72 65 73 | 74 20 6f 66 20 74 68 65 | the res|t of the|
|00000c20| 20 72 65 73 6f 75 72 63 | 65 2e 20 20 49 74 20 69 | resourc|e.  It i|
|00000c30| 73 20 67 65 6e 65 72 61 | 74 65 64 20 62 79 20 73 |s genera|ted by s|
|00000c40| 75 6d 6d 69 6e 67 20 61 | 6c 6c 20 74 68 65 20 73 |umming a|ll the s|
|00000c50| 75 62 73 65 71 75 65 6e | 74 20 6c 6f 6e 67 77 6f |ubsequen|t longwo|
|00000c60| 72 64 73 20 69 6e 20 74 | 68 65 20 72 65 73 6f 75 |rds in t|he resou|
|00000c70| 72 63 65 20 68 61 6e 64 | 6c 65 2c 20 73 6b 69 70 |rce hand|le, skip|
|00000c80| 70 69 6e 67 20 74 68 65 | 20 63 68 65 63 6b 73 75 |ping the| checksu|
|00000c90| 6d 20 66 69 65 6c 64 20 | 69 74 73 65 6c 66 20 61 |m field |itself a|
|00000ca0| 6e 64 20 61 6e 79 20 65 | 78 74 72 61 20 62 79 74 |nd any e|xtra byt|
|00000cb0| 65 73 20 61 74 20 74 68 | 65 20 65 6e 64 20 74 68 |es at th|e end th|
|00000cc0| 61 74 20 64 6f 6e d5 74 | 20 63 6f 6d 70 6f 73 65 |at don.t| compose|
|00000cd0| 20 61 20 6c 6f 6e 67 77 | 6f 72 64 2e 0d 72 65 61 | a longw|ord..rea|
|00000ce0| 64 4f 6e 6c 79 09 54 68 | 69 73 20 74 77 6f 2d 62 |dOnly.Th|is two-b|
|00000cf0| 79 74 65 20 66 69 65 6c | 64 20 69 6e 64 69 63 61 |yte fiel|d indica|
|00000d00| 74 65 73 20 77 68 65 74 | 68 65 72 20 74 68 65 20 |tes whet|her the |
|00000d10| 61 74 74 61 63 68 65 64 | 20 66 69 6c 65 20 69 73 |attached| file is|
|00000d20| 20 63 68 65 63 6b 65 64 | 20 6f 75 74 20 66 6f 72 | checked| out for|
|00000d30| 20 6d 6f 64 69 66 69 63 | 61 74 69 6f 6e 73 20 6f | modific|ations o|
|00000d40| 72 20 6e 6f 74 2e 20 20 | 49 66 20 74 68 65 20 66 |r not.  |If the f|
|00000d50| 69 6c 65 20 69 73 20 6e | 6f 74 20 63 68 65 63 6b |ile is n|ot check|
|00000d60| 65 64 20 6f 75 74 20 66 | 6f 72 20 6d 6f 64 69 66 |ed out f|or modif|
|00000d70| 69 63 61 74 69 6f 6e 73 | 2c 20 74 68 69 73 20 66 |ications|, this f|
|00000d80| 69 65 6c 64 20 63 6f 6e | 74 61 69 6e 73 20 61 20 |ield con|tains a |
|00000d90| 7a 65 72 6f 2e 20 20 49 | 66 20 74 68 65 20 66 69 |zero.  I|f the fi|
|00000da0| 6c 65 20 69 73 20 6d 6f | 64 69 66 69 61 62 6c 65 |le is mo|difiable|
|00000db0| 2c 20 74 68 69 73 20 66 | 69 65 6c 64 20 69 73 20 |, this f|ield is |
|00000dc0| 6e 6f 6e 2d 7a 65 72 6f | 20 61 6e 64 20 63 6f 6e |non-zero| and con|
|00000dd0| 74 61 69 6e 73 20 73 70 | 65 63 69 61 6c 20 76 65 |tains sp|ecial ve|
|00000de0| 72 73 69 6f 6e 20 69 6e | 66 6f 72 6d 61 74 69 6f |rsion in|formatio|
|00000df0| 6e 20 66 6f 72 20 50 72 | 6f 6a 65 63 74 6f 72 2e |n for Pr|ojector.|
|00000e00| 0d 6d 6f 64 69 66 79 52 | 65 61 64 4f 6e 6c 79 09 |.modifyR|eadOnly.|
|00000e10| 54 68 69 73 20 6f 6e 65 | 2d 62 79 74 65 20 66 69 |This one|-byte fi|
|00000e20| 65 6c 64 20 70 72 6f 76 | 69 64 65 73 20 61 20 6c |eld prov|ides a l|
|00000e30| 69 6d 69 74 65 64 20 6f | 76 65 72 72 69 64 65 20 |imited o|verride |
|00000e40| 74 6f 20 74 68 65 20 72 | 65 61 64 4f 6e 6c 79 20 |to the r|eadOnly |
|00000e50| 66 69 65 6c 64 2e 20 20 | 53 6f 6d 65 74 69 6d 65 |field.  |Sometime|
|00000e60| 73 20 69 74 20 69 73 20 | 64 65 73 69 72 61 62 6c |s it is |desirabl|
|00000e70| 65 20 74 6f 20 62 65 20 | 61 62 6c 65 20 74 6f 20 |e to be |able to |
|00000e80| 6d 6f 64 69 66 79 20 61 | 20 66 69 6c 65 20 74 68 |modify a| file th|
|00000e90| 61 74 20 68 61 73 20 62 | 65 65 6e 20 63 68 65 63 |at has b|een chec|
|00000ea0| 6b 65 64 20 6f 75 74 20 | 72 65 61 64 2d 6f 6e 6c |ked out |read-onl|
|00000eb0| 79 2e 20 20 4f 6e 65 20 | 6d 61 79 20 77 61 6e 74 |y.  One |may want|
|00000ec0| 20 74 6f 20 64 6f 20 74 | 68 69 73 20 69 66 20 74 | to do t|his if t|
|00000ed0| 68 65 79 20 68 61 76 65 | 20 61 20 66 69 6c 65 20 |hey have| a file |
|00000ee0| 63 68 65 63 6b 65 64 20 | 6f 75 74 20 72 65 61 64 |checked |out read|
|00000ef0| 2d 6f 6e 6c 79 2c 20 62 | 75 74 20 6c 61 74 65 72 |-only, b|ut later|
|00000f00| 20 64 65 63 69 64 65 20 | 74 6f 20 6d 61 6b 65 20 | decide |to make |
|00000f10| 6d 6f 64 69 66 69 63 61 | 74 69 6f 6e 73 20 74 6f |modifica|tions to|
|00000f20| 20 69 74 20 61 6e 64 20 | 6e 6f 20 6c 6f 6e 67 65 | it and |no longe|
|00000f30| 72 20 68 61 76 65 20 61 | 63 63 65 73 73 20 74 6f |r have a|ccess to|
|00000f40| 20 74 68 65 20 50 72 6f | 6a 65 63 74 6f 72 20 64 | the Pro|jector d|
|00000f50| 61 74 61 62 61 73 65 20 | 74 6f 20 63 68 65 63 6b |atabase |to check|
|00000f60| 20 6f 75 74 20 61 20 6d | 6f 64 69 66 69 61 62 6c | out a m|odifiabl|
|00000f70| 65 20 76 65 72 73 69 6f | 6e 2e 20 20 55 6e 64 65 |e versio|n.  Unde|
|00000f80| 72 20 4d 50 57 2c 20 74 | 68 65 20 75 73 65 72 20 |r MPW, t|he user |
|00000f90| 63 61 6e 20 65 78 65 63 | 75 74 65 20 74 68 65 20 |can exec|ute the |
|00000fa0| 4d 6f 64 69 66 79 52 65 | 61 64 4f 6e 6c 79 20 63 |ModifyRe|adOnly c|
|00000fb0| 6f 6d 6d 61 6e 64 2e 20 | 20 54 68 69 73 20 73 65 |ommand. | This se|
|00000fc0| 74 73 20 74 68 65 20 6d | 6f 64 69 66 79 52 65 61 |ts the m|odifyRea|
|00000fd0| 64 4f 6e 6c 79 20 66 69 | 65 6c 64 20 74 6f 20 6e |dOnly fi|eld to n|
|00000fe0| 6f 6e 2d 7a 65 72 6f 2c | 20 69 6e 64 69 63 61 74 |on-zero,| indicat|
|00000ff0| 69 6e 67 20 74 68 61 74 | 20 74 68 65 20 66 69 6c |ing that| the fil|
|00001000| 65 20 63 61 6e 20 62 65 | 20 65 64 69 74 65 64 2c |e can be| edited,|
|00001010| 20 65 76 65 6e 20 74 68 | 6f 75 67 68 20 69 74 20 | even th|ough it |
|00001020| 69 73 20 63 68 65 63 6b | 65 64 20 6f 75 74 20 72 |is check|ed out r|
|00001030| 65 61 64 2d 6f 6e 6c 79 | 2e 0d 49 6e 20 79 6f 75 |ead-only|..In you|
|00001040| 72 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 2c 20 79 |r applic|ation, y|
|00001050| 6f 75 20 6d 61 79 20 77 | 69 73 68 20 74 6f 20 69 |ou may w|ish to i|
|00001060| 6e 68 69 62 69 74 20 6d | 6f 64 69 66 69 63 61 74 |nhibit m|odificat|
|00001070| 69 6f 6e 73 20 74 6f 20 | 61 20 66 69 6c 65 20 69 |ions to |a file i|
|00001080| 66 20 69 74 20 68 61 73 | 20 61 20 27 63 6b 69 64 |f it has| a 'ckid|
|00001090| 27 20 72 65 73 6f 75 72 | 63 65 20 61 6e 64 20 68 |' resour|ce and h|
|000010a0| 61 73 20 62 65 65 6e 20 | 63 68 65 63 6b 65 64 20 |as been |checked |
|000010b0| 6f 75 74 20 72 65 61 64 | 2d 6f 6e 6c 79 2e 20 20 |out read|-only.  |
|000010c0| 49 6e 20 61 64 64 69 74 | 69 6f 6e 2c 20 61 73 20 |In addit|ion, as |
|000010d0| 61 20 63 6f 6e 76 65 6e | 69 65 6e 63 65 20 74 6f |a conven|ience to|
|000010e0| 20 79 6f 75 72 20 63 75 | 73 74 6f 6d 65 72 73 2c | your cu|stomers,|
|000010f0| 20 79 6f 75 20 6d 61 79 | 20 77 69 73 68 20 74 6f | you may| wish to|
|00001100| 20 69 6e 63 6c 75 64 65 | 20 61 20 4d 6f 64 69 66 | include| a Modif|
|00001110| 79 52 65 61 64 4f 6e 6c | 79 20 66 65 61 74 75 72 |yReadOnl|y featur|
|00001120| 65 20 6f 66 20 79 6f 75 | 72 20 6f 77 6e 2e 20 20 |e of you|r own.  |
|00001130| 54 6f 20 64 6f 20 74 68 | 69 73 2c 20 79 6f 75 20 |To do th|is, you |
|00001140| 77 6f 75 6c 64 20 6e 65 | 65 64 20 74 6f 20 73 65 |would ne|ed to se|
|00001150| 74 20 74 68 65 20 6d 6f | 64 69 66 79 52 65 61 64 |t the mo|difyRead|
|00001160| 4f 6e 6c 79 20 66 69 65 | 6c 64 20 74 6f 20 6e 6f |Only fie|ld to no|
|00001170| 6e 2d 7a 65 72 6f 20 61 | 6e 64 20 72 65 63 61 6c |n-zero a|nd recal|
|00001180| 63 75 6c 61 74 65 20 74 | 68 65 20 63 68 65 63 6b |culate t|he check|
|00001190| 73 75 6d 2e 0d 54 68 65 | 20 66 6f 6c 6c 6f 77 69 |sum..The| followi|
|000011a0| 6e 67 20 72 6f 75 74 69 | 6e 65 73 20 63 61 6e 20 |ng routi|nes can |
|000011b0| 68 65 6c 70 20 70 65 72 | 66 6f 72 6d 20 74 68 65 |help per|form the|
|000011c0| 73 65 20 66 75 6e 63 74 | 69 6f 6e 73 2e 20 20 43 |se funct|ions.  C|
|000011d0| 4b 49 44 49 73 4d 6f 64 | 69 66 69 61 62 6c 65 20 |KIDIsMod|ifiable |
|000011e0| 74 61 6b 65 73 20 61 20 | 68 61 6e 64 6c 65 20 74 |takes a |handle t|
|000011f0| 6f 20 61 20 27 63 6b 69 | 64 27 20 72 65 73 6f 75 |o a 'cki|d' resou|
|00001200| 72 63 65 20 61 6e 64 20 | 72 65 74 75 72 6e 73 20 |rce and |returns |
|00001210| 54 52 55 45 20 69 66 20 | 69 74 20 69 6e 64 69 63 |TRUE if |it indic|
|00001220| 61 74 65 73 20 74 68 61 | 74 20 74 68 65 20 66 69 |ates tha|t the fi|
|00001230| 6c 65 20 69 73 20 6d 6f | 64 69 66 69 61 62 6c 65 |le is mo|difiable|
|00001240| 20 61 6e 64 20 46 41 4c | 53 45 20 6f 74 68 65 72 | and FAL|SE other|
|00001250| 77 69 73 65 2e 20 20 48 | 61 6e 64 6c 65 43 68 65 |wise.  H|andleChe|
|00001260| 63 6b 53 75 6d 20 74 61 | 6b 65 73 20 61 20 68 61 |ckSum ta|kes a ha|
|00001270| 6e 64 6c 65 20 74 6f 20 | 61 20 27 63 6b 69 64 27 |ndle to |a 'ckid'|
|00001280| 20 72 65 73 6f 75 72 63 | 65 20 61 6e 64 20 72 65 | resourc|e and re|
|00001290| 74 75 72 6e 73 20 61 20 | 63 61 6c 63 75 6c 61 74 |turns a |calculat|
|000012a0| 65 64 20 63 68 65 63 6b | 73 75 6d 2e 0d 4d 50 57 |ed check|sum..MPW|
|000012b0| 20 50 61 73 63 61 6c 0d | 54 59 50 45 0d 20 20 43 | Pascal.|TYPE.  C|
|000012c0| 4b 49 44 52 65 63 20 20 | 20 20 20 20 20 20 20 3d |KIDRec  |       =|
|000012d0| 20 50 41 43 4b 45 44 20 | 52 45 43 4f 52 44 0d 20 | PACKED |RECORD. |
|000012e0| 20 20 20 63 68 65 63 6b | 53 75 6d 3a 20 20 20 20 |   check|Sum:    |
|000012f0| 20 20 20 4c 4f 4e 47 49 | 4e 54 3b 0d 20 20 20 20 |   LONGI|NT;.    |
|00001300| 4c 4f 43 3a 20 20 20 20 | 20 20 20 20 20 20 20 20 |LOC:    |        |
|00001310| 4c 4f 4e 47 49 4e 54 3b | 0d 20 20 20 20 76 65 72 |LONGINT;|.    ver|
|00001320| 73 69 6f 6e 3a 20 20 20 | 20 20 20 20 20 49 4e 54 |sion:   |     INT|
|00001330| 45 47 45 52 3b 0d 20 20 | 20 20 72 65 61 64 4f 6e |EGER;.  |  readOn|
|00001340| 6c 79 3a 20 20 20 20 20 | 20 20 49 4e 54 45 47 45 |ly:     |  INTEGE|
|00001350| 52 3b 0d 20 20 20 20 62 | 72 61 6e 63 68 3a 20 20 |R;.    b|ranch:  |
|00001360| 20 20 20 20 20 20 20 42 | 59 54 45 3b 0d 20 20 20 |       B|YTE;.   |
|00001370| 20 6d 6f 64 69 66 79 52 | 65 61 64 4f 6e 6c 79 3a | modifyR|eadOnly:|
|00001380| 20 42 6f 6f 6c 65 61 6e | 3b 0d 20 20 20 20 7b 20 | Boolean|;.    { |
|00001390| 54 68 65 72 65 d5 73 20 | 6d 6f 72 65 2c 20 62 75 |There.s |more, bu|
|000013a0| 74 20 74 68 69 73 20 69 | 73 20 61 6c 6c 20 77 65 |t this i|s all we|
|000013b0| 20 6e 65 65 64 20 7d 0d | 20 20 20 20 45 4e 44 3b | need }.|    END;|
|000013c0| 0d 20 20 43 4b 49 44 50 | 74 72 20 20 20 20 20 20 |.  CKIDP|tr      |
|000013d0| 20 20 20 3d 20 5e 43 4b | 49 44 52 65 63 3b 0d 20 |   = ^CK|IDRec;. |
|000013e0| 20 43 4b 49 44 48 61 6e | 64 6c 65 20 20 20 20 20 | CKIDHan|dle     |
|000013f0| 20 3d 20 5e 43 4b 49 44 | 50 74 72 3b 0d 46 55 4e | = ^CKID|Ptr;.FUN|
|00001400| 43 54 49 4f 4e 20 43 4b | 49 44 49 73 4d 6f 64 69 |CTION CK|IDIsModi|
|00001410| 66 69 61 62 6c 65 28 63 | 6b 69 64 3a 20 43 4b 49 |fiable(c|kid: CKI|
|00001420| 44 48 61 6e 64 6c 65 29 | 3a 20 42 6f 6f 6c 65 61 |DHandle)|: Boolea|
|00001430| 6e 3b 0d 20 20 42 45 47 | 49 4e 0d 20 20 20 20 49 |n;.  BEG|IN.    I|
|00001440| 46 20 63 6b 69 64 20 3d | 20 4e 49 4c 20 54 48 45 |F ckid =| NIL THE|
|00001450| 4e 0d 20 20 20 20 20 20 | 43 4b 49 44 49 73 4d 6f |N.      |CKIDIsMo|
|00001460| 64 69 66 69 61 62 6c 65 | 20 3a 3d 20 54 52 55 45 |difiable| := TRUE|
|00001470| 0d 20 20 20 20 45 4c 53 | 45 0d 20 20 20 20 20 20 |.    ELS|E.      |
|00001480| 57 49 54 48 20 63 6b 69 | 64 5e 5e 20 44 4f 0d 20 |WITH cki|d^^ DO. |
|00001490| 20 20 20 20 20 20 20 43 | 4b 49 44 49 73 4d 6f 64 |       C|KIDIsMod|
|000014a0| 69 66 69 61 62 6c 65 20 | 3a 3d 20 28 72 65 61 64 |ifiable |:= (read|
|000014b0| 4f 6e 6c 79 20 3c 3e 20 | 30 29 20 7c 0d 20 20 20 |Only <> |0) |.   |
|000014c0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000014d0| 20 20 20 20 20 20 20 28 | 28 72 65 61 64 4f 6e 6c |       (|(readOnl|
|000014e0| 79 20 3d 20 30 29 20 26 | 20 6d 6f 64 69 66 79 52 |y = 0) &| modifyR|
|000014f0| 65 61 64 4f 6e 6c 79 29 | 3b 0d 20 20 45 4e 44 3b |eadOnly)|;.  END;|
|00001500| 0d 46 55 4e 43 54 49 4f | 4e 20 48 61 6e 64 6c 65 |.FUNCTIO|N Handle|
|00001510| 43 68 65 63 6b 53 75 6d | 28 68 3a 20 48 61 6e 64 |CheckSum|(h: Hand|
|00001520| 6c 65 29 3a 20 4c 4f 4e | 47 49 4e 54 3b 0d 20 20 |le): LON|GINT;.  |
|00001530| 56 41 52 0d 20 20 20 20 | 73 75 6d 3a 20 20 20 20 |VAR.    |sum:    |
|00001540| 20 20 20 20 20 20 20 20 | 20 4c 4f 4e 47 49 4e 54 |        | LONGINT|
|00001550| 3b 0d 20 20 20 20 73 69 | 7a 65 3a 20 20 20 20 20 |;.    si|ze:     |
|00001560| 20 20 20 20 20 20 20 4c | 4f 4e 47 49 4e 54 3b 0d |       L|ONGINT;.|
|00001570| 20 20 20 20 70 3a 20 20 | 20 20 20 20 20 20 20 20 |    p:  |        |
|00001580| 20 20 20 20 20 4c 6f 6e | 67 69 6e 74 50 74 72 3b |     Lon|gintPtr;|
|00001590| 0d 20 20 42 45 47 49 4e | 0d 20 20 20 20 73 75 6d |.  BEGIN|.    sum|
|000015a0| 20 3a 3d 20 30 3b 0d 20 | 20 20 20 73 69 7a 65 20 | := 0;. |   size |
|000015b0| 3a 3d 20 28 47 65 74 48 | 61 6e 64 6c 65 53 69 7a |:= (GetH|andleSiz|
|000015c0| 65 28 68 29 20 44 49 56 | 20 53 69 7a 65 4f 66 28 |e(h) DIV| SizeOf(|
|000015d0| 4c 4f 4e 47 49 4e 54 29 | 29 20 2d 20 31 3b 0d 20 |LONGINT)|) - 1;. |
|000015e0| 20 20 20 70 20 3a 3d 20 | 4c 6f 6e 67 69 6e 74 50 |   p := |LongintP|
|000015f0| 74 72 28 68 5e 29 3b 0d | 20 20 20 20 70 20 3a 3d |tr(h^);.|    p :=|
|00001600| 20 4c 6f 6e 67 69 6e 74 | 50 74 72 28 4f 52 44 28 | Longint|Ptr(ORD(|
|00001610| 70 29 20 2b 20 53 69 7a | 65 4f 66 28 4c 4f 4e 47 |p) + Siz|eOf(LONG|
|00001620| 49 4e 54 29 29 3b 20 7b | 20 73 6b 69 70 20 6f 76 |INT)); {| skip ov|
|00001630| 65 72 20 66 69 72 73 74 | 20 6c 6f 6e 67 0d 20 20 |er first| long.  |
|00001640| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001650| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001660| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 28 63 |        |      (c|
|00001670| 68 65 63 6b 73 75 6d 20 | 66 69 65 6c 64 29 20 7d |hecksum |field) }|
|00001680| 0d 20 20 20 20 57 48 49 | 4c 45 20 28 73 69 7a 65 |.    WHI|LE (size|
|00001690| 20 3e 20 30 29 20 44 4f | 20 42 45 47 49 4e 0d 20 | > 0) DO| BEGIN. |
|000016a0| 20 20 20 20 20 73 69 7a | 65 20 3a 3d 20 73 69 7a |     siz|e := siz|
|000016b0| 65 20 2d 20 31 3b 0d 20 | 20 20 20 20 20 73 75 6d |e - 1;. |     sum|
|000016c0| 20 3a 3d 20 73 75 6d 20 | 2b 20 70 5e 3b 0d 20 20 | := sum |+ p^;.  |
|000016d0| 20 20 20 20 70 20 3a 3d | 20 4c 6f 6e 67 69 6e 74 |    p :=| Longint|
|000016e0| 50 74 72 28 4f 52 44 28 | 70 29 20 2b 20 53 69 7a |Ptr(ORD(|p) + Siz|
|000016f0| 65 4f 66 28 4c 4f 4e 47 | 49 4e 54 29 29 3b 0d 20 |eOf(LONG|INT));. |
|00001700| 20 20 20 45 4e 44 3b 0d | 20 20 20 20 48 61 6e 64 |   END;.|    Hand|
|00001710| 6c 65 43 68 65 63 6b 53 | 75 6d 20 3a 3d 20 73 75 |leCheckS|um := su|
|00001720| 6d 3b 0d 20 20 45 4e 44 | 3b 0d 4d 50 57 20 43 0d |m;.  END|;.MPW C.|
|00001730| 74 79 70 65 64 65 66 20 | 75 6e 73 69 67 6e 65 64 |typedef |unsigned|
|00001740| 20 6c 6f 6e 67 20 75 4c | 6f 6e 67 3b 0d 74 79 70 | long uL|ong;.typ|
|00001750| 65 64 65 66 20 73 74 72 | 75 63 74 20 7b 0d 20 20 |edef str|uct {.  |
|00001760| 75 4c 6f 6e 67 20 20 20 | 20 20 20 63 68 65 63 6b |uLong   |   check|
|00001770| 53 75 6d 3b 0d 20 20 6c | 6f 6e 67 20 20 20 20 20 |Sum;.  l|ong     |
|00001780| 20 20 4c 4f 43 3b 0d 20 | 20 73 68 6f 72 74 20 20 |  LOC;. | short  |
|00001790| 20 20 20 20 76 65 72 73 | 69 6f 6e 3b 0d 20 20 73 |    vers|ion;.  s|
|000017a0| 68 6f 72 74 20 20 20 20 | 20 20 72 65 61 64 4f 6e |hort    |  readOn|
|000017b0| 6c 79 3b 0d 20 20 63 68 | 61 72 20 20 20 20 20 20 |ly;.  ch|ar      |
|000017c0| 20 62 72 61 6e 63 68 3b | 0d 20 20 42 6f 6f 6c 65 | branch;|.  Boole|
|000017d0| 61 6e 20 20 20 20 6d 6f | 64 69 66 79 52 65 61 64 |an    mo|difyRead|
|000017e0| 4f 6e 6c 79 3b 0d 20 20 | 2f 2a 20 54 68 65 72 65 |Only;.  |/* There|
|000017f0| d5 73 20 6d 6f 72 65 2c | 20 62 75 74 20 74 68 69 |.s more,| but thi|
|00001800| 73 20 69 73 20 61 6c 6c | 20 77 65 20 6e 65 65 64 |s is all| we need|
|00001810| 20 2a 2f 0d 7d 20 43 4b | 49 44 52 65 63 2c 20 2a | */.} CK|IDRec, *|
|00001820| 43 4b 49 44 50 74 72 2c | 20 2a 2a 43 4b 49 44 48 |CKIDPtr,| **CKIDH|
|00001830| 61 6e 64 6c 65 3b 0d 70 | 61 73 63 61 6c 20 42 6f |andle;.p|ascal Bo|
|00001840| 6f 6c 65 61 6e 20 43 4b | 49 44 49 73 4d 6f 64 69 |olean CK|IDIsModi|
|00001850| 66 69 61 62 6c 65 28 43 | 4b 49 44 48 61 6e 64 6c |fiable(C|KIDHandl|
|00001860| 65 20 63 6b 69 64 29 0d | 7b 0d 20 20 69 66 20 28 |e ckid).|{.  if (|
|00001870| 63 6b 69 64 20 3d 3d 20 | 6e 69 6c 29 20 0d 20 20 |ckid == |nil) .  |
|00001880| 20 20 72 65 74 75 72 6e | 28 74 72 75 65 29 3b 0d |  return|(true);.|
|00001890| 20 20 65 6c 73 65 0d 20 | 20 20 20 72 65 74 75 72 |  else. |   retur|
|000018a0| 6e 28 20 28 28 2a 2a 63 | 6b 69 64 29 2e 72 65 61 |n( ((**c|kid).rea|
|000018b0| 64 4f 6e 6c 79 20 21 3d | 20 30 29 20 7c 7c 0d 20 |dOnly !=| 0) ||. |
|000018c0| 20 20 20 20 20 20 20 20 | 20 20 28 28 28 2a 2a 63 |        |  (((**c|
|000018d0| 6b 69 64 29 2e 72 65 61 | 64 4f 6e 6c 79 20 3d 3d |kid).rea|dOnly ==|
|000018e0| 20 30 29 20 26 26 20 28 | 2a 2a 63 6b 69 64 29 2e | 0) && (|**ckid).|
|000018f0| 6d 6f 64 69 66 79 52 65 | 61 64 4f 6e 6c 79 29 29 |modifyRe|adOnly))|
|00001900| 3b 0d 7d 0d 70 61 73 63 | 61 6c 20 75 4c 6f 6e 67 |;.}.pasc|al uLong|
|00001910| 20 48 61 6e 64 6c 65 43 | 68 65 63 6b 53 75 6d 28 | HandleC|heckSum(|
|00001920| 48 61 6e 64 6c 65 20 68 | 29 0d 7b 0d 20 20 6c 6f |Handle h|).{.  lo|
|00001930| 6e 67 20 20 20 20 20 20 | 20 73 69 7a 65 3b 0d 20 |ng      | size;. |
|00001940| 20 75 4c 6f 6e 67 20 20 | 20 20 20 20 73 75 6d 20 | uLong  |    sum |
|00001950| 3d 20 30 3b 0d 20 20 75 | 4c 6f 6e 67 20 20 20 20 |= 0;.  u|Long    |
|00001960| 20 20 2a 70 3b 0d 20 20 | 73 69 7a 65 20 3d 20 28 |  *p;.  |size = (|
|00001970| 47 65 74 48 61 6e 64 6c | 65 53 69 7a 65 28 68 29 |GetHandl|eSize(h)|
|00001980| 20 2f 20 73 69 7a 65 6f | 66 28 6c 6f 6e 67 29 29 | / sizeo|f(long))|
|00001990| 20 2d 20 31 3b 0d 20 20 | 70 20 3d 20 28 75 4c 6f | - 1;.  |p = (uLo|
|000019a0| 6e 67 20 2a 29 20 2a 68 | 3b 0d 20 20 70 2b 2b 3b |ng *) *h|;.  p++;|
|000019b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000019c0| 20 20 20 20 2f 2a 20 73 | 6b 69 70 20 6f 76 65 72 |    /* s|kip over|
|000019d0| 20 66 69 72 73 74 20 6c | 6f 6e 67 20 28 63 68 65 | first l|ong (che|
|000019e0| 63 6b 73 75 6d 20 66 69 | 65 6c 64 29 20 2a 2f 0d |cksum fi|eld) */.|
|000019f0| 20 20 77 68 69 6c 65 20 | 28 73 69 7a 65 2d 2d 20 |  while |(size-- |
|00001a00| 3e 20 30 29 20 7b 0d 20 | 20 20 20 73 75 6d 20 2b |> 0) {. |   sum +|
|00001a10| 3d 20 2a 70 2b 2b 3b 0d | 20 20 7d 0d 20 20 72 65 |= *p++;.|  }.  re|
|00001a20| 74 75 72 6e 28 73 75 6d | 29 3b 0d 7d 0d 49 66 20 |turn(sum|);.}.If |
|00001a30| 79 6f 75 20 77 61 6e 74 | 65 64 20 74 6f 20 69 6e |you want|ed to in|
|00001a40| 63 6c 75 64 65 20 61 20 | 4d 6f 64 69 66 79 52 65 |clude a |ModifyRe|
|00001a50| 61 64 4f 6e 6c 79 20 66 | 75 6e 63 74 69 6f 6e 2c |adOnly f|unction,|
|00001a60| 20 79 6f 75 20 63 6f 75 | 6c 64 20 75 73 65 20 73 | you cou|ld use s|
|00001a70| 6f 6d 65 74 68 69 6e 67 | 20 6c 69 6b 65 20 74 68 |omething| like th|
|00001a80| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 50 61 73 63 |e follow|ing Pasc|
|00001a90| 61 6c 20 66 72 61 67 6d | 65 6e 74 3a 0d 20 20 68 |al fragm|ent:.  h|
|00001aa0| 20 3a 3d 20 43 4b 49 44 | 48 61 6e 64 6c 65 28 47 | := CKID|Handle(G|
|00001ab0| 65 74 31 52 65 73 6f 75 | 72 63 65 28 27 63 6b 69 |et1Resou|rce('cki|
|00001ac0| 64 27 2c 20 31 32 38 29 | 29 3b 0d 20 20 49 46 20 |d', 128)|);.  IF |
|00001ad0| 28 68 20 3c 3e 20 4e 49 | 4c 29 20 26 20 28 68 5e |(h <> NI|L) & (h^|
|00001ae0| 5e 2e 76 65 72 73 69 6f | 6e 20 3d 20 34 29 20 54 |^.versio|n = 4) T|
|00001af0| 48 45 4e 20 42 45 47 49 | 4e 0d 20 20 20 20 68 5e |HEN BEGI|N.    h^|
|00001b00| 5e 2e 6d 6f 64 69 66 79 | 52 65 61 64 4f 6e 6c 79 |^.modify|ReadOnly|
|00001b10| 20 3a 3d 20 54 52 55 45 | 3b 0d 20 20 20 20 68 5e | := TRUE|;.    h^|
|00001b20| 5e 2e 63 68 65 63 6b 53 | 75 6d 20 3a 3d 20 48 61 |^.checkS|um := Ha|
|00001b30| 6e 64 6c 65 43 68 65 63 | 6b 53 75 6d 28 48 61 6e |ndleChec|kSum(Han|
|00001b40| 64 6c 65 28 68 29 29 3b | 0d 20 20 20 20 43 68 61 |dle(h));|.    Cha|
|00001b50| 6e 67 65 64 52 65 73 6f | 75 72 63 65 28 48 61 6e |ngedReso|urce(Han|
|00001b60| 64 6c 65 28 68 29 29 3b | 0d 20 20 45 4e 44 3b 0d |dle(h));|.  END;.|
|00001b70| 27 63 6b 69 64 27 20 52 | 65 73 6f 75 72 63 65 20 |'ckid' R|esource |
|00001b80| 66 6f 72 6d 61 74 0d 54 | 68 69 73 20 4d 50 57 20 |format.T|his MPW |
|00001b90| 52 65 7a 20 72 65 73 6f | 75 72 63 65 20 74 65 6d |Rez reso|urce tem|
|00001ba0| 70 6c 61 74 65 20 69 73 | 20 66 6f 72 20 79 6f 75 |plate is| for you|
|00001bb0| 72 20 61 70 70 6c 69 63 | 61 74 69 6f 6e d5 73 20 |r applic|ation.s |
|00001bc0| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 6f 6e 6c 79 |informat|ion only|
|00001bd0| 2e 20 20 49 74 20 69 73 | 20 76 61 6c 69 64 20 6f |.  It is| valid o|
|00001be0| 6e 6c 79 20 66 6f 72 20 | 76 65 72 73 69 6f 6e 20 |nly for |version |
|00001bf0| 34 20 6f 66 20 74 68 65 | 20 72 65 73 6f 75 72 63 |4 of the| resourc|
|00001c00| 65 2e 20 20 50 6c 65 61 | 73 65 20 64 6f 20 6e 6f |e.  Plea|se do no|
|00001c10| 74 20 77 72 69 74 65 20 | 74 6f 20 74 68 69 73 20 |t write |to this |
|00001c20| 72 65 73 6f 75 72 63 65 | 20 6f 72 20 63 72 65 61 |resource| or crea|
|00001c30| 74 65 20 6f 6e 65 20 6f | 66 20 79 6f 75 72 20 6f |te one o|f your o|
|00001c40| 77 6e 2e 20 20 49 66 20 | 79 6f 75 20 66 65 65 6c |wn.  If |you feel|
|00001c50| 20 74 68 61 74 20 79 6f | 75 20 6e 65 65 64 20 74 | that yo|u need t|
|00001c60| 6f 20 63 68 61 6e 67 65 | 20 66 69 65 6c 64 73 20 |o change| fields |
|00001c70| 69 6e 20 74 68 65 20 72 | 65 73 6f 75 72 63 65 2c |in the r|esource,|
|00001c80| 20 74 68 65 6e 20 6c 69 | 6d 69 74 20 79 6f 75 72 | then li|mit your|
|00001c90| 73 65 6c 66 20 74 6f 20 | 74 68 65 20 63 68 65 63 |self to |the chec|
|00001ca0| 6b 53 75 6d 20 61 6e 64 | 20 6d 6f 64 69 66 79 52 |kSum and| modifyR|
|00001cb0| 65 61 64 4f 6e 6c 79 20 | 66 69 65 6c 64 73 2c 20 |eadOnly |fields, |
|00001cc0| 61 6e 64 20 6f 6e 6c 79 | 20 69 66 20 74 68 65 20 |and only| if the |
|00001cd0| 76 65 72 73 69 6f 6e 20 | 66 69 65 6c 64 20 69 73 |version |field is|
|00001ce0| 20 65 71 75 61 6c 20 74 | 6f 20 34 2e 20 20 54 68 | equal t|o 4.  Th|
|00001cf0| 69 73 20 72 65 73 6f 75 | 72 63 65 20 66 6f 72 6d |is resou|rce form|
|00001d00| 61 74 20 77 69 6c 6c 20 | 63 68 61 6e 67 65 20 69 |at will |change i|
|00001d10| 6e 20 74 68 65 20 66 75 | 74 75 72 65 2e 0d 74 79 |n the fu|ture..ty|
|00001d20| 70 65 20 27 63 6b 69 64 | 27 0d 20 20 20 7b 0d 20 |pe 'ckid|'.   {. |
|00001d30| 20 20 75 6e 73 69 67 6e | 65 64 20 6c 6f 6e 67 69 |  unsign|ed longi|
|00001d40| 6e 74 3b 20 20 20 20 20 | 20 20 20 2f 2a 20 63 68 |nt;     |   /* ch|
|00001d50| 65 63 6b 53 75 6d 20 2a | 2f 0d 20 20 20 75 6e 73 |eckSum *|/.   uns|
|00001d60| 69 67 6e 65 64 20 6c 6f | 6e 67 69 6e 74 20 4c 4f |igned lo|ngint LO|
|00001d70| 43 20 3d 20 31 30 37 31 | 39 38 35 32 30 30 3b 20 |C = 1071|985200; |
|00001d80| 20 2f 2a 20 6c 6f 63 61 | 74 69 6f 6e 20 69 64 65 | /* loca|tion ide|
|00001d90| 6e 74 69 66 69 65 72 20 | 2a 2f 0d 20 20 20 69 6e |ntifier |*/.   in|
|00001da0| 74 65 67 65 72 20 76 65 | 72 73 69 6f 6e 20 3d 20 |teger ve|rsion = |
|00001db0| 34 3b 20 20 20 20 20 2f | 2a 20 63 6b 69 64 20 76 |4;     /|* ckid v|
|00001dc0| 65 72 73 69 6f 6e 20 6e | 75 6d 62 65 72 20 2a 2f |ersion n|umber */|
|00001dd0| 0d 20 20 20 69 6e 74 65 | 67 65 72 20 72 65 61 64 |.   inte|ger read|
|00001de0| 4f 6e 6c 79 20 3d 20 30 | 3b 20 20 20 20 2f 2a 20 |Only = 0|;    /* |
|00001df0| 43 68 65 63 6b 20 6f 75 | 74 20 73 74 61 74 65 2c |Check ou|t state,|
|00001e00| 20 69 66 20 3d 20 30 20 | 69 74 20 69 73 20 6d 6f | if = 0 |it is mo|
|00001e10| 64 69 66 69 61 62 6c 65 | 20 2a 2f 0d 20 20 20 42 |difiable| */.   B|
|00001e20| 79 74 65 20 6e 6f 42 72 | 61 6e 63 68 20 3d 20 30 |yte noBr|anch = 0|
|00001e30| 3b 20 20 20 20 20 20 20 | 2f 2a 20 69 66 20 6d 6f |;       |/* if mo|
|00001e40| 64 69 66 69 61 62 6c 65 | 20 26 20 42 79 74 65 20 |difiable| & Byte |
|00001e50| 21 3d 20 30 20 74 68 65 | 6e 20 62 72 61 6e 63 68 |!= 0 the|n branch|
|00001e60| 20 77 61 73 20 6d 61 64 | 65 0d 20 20 20 20 20 20 | was mad|e.      |
|00001e70| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001e80| 20 20 20 20 20 20 20 20 | 20 6f 6e 20 63 68 65 63 |        | on chec|
|00001e90| 6b 20 6f 75 74 20 2a 2f | 0d 20 20 20 42 79 74 65 |k out */|.   Byte|
|00001ea0| 20 63 6c 65 61 6e 20 3d | 20 30 2c 0d 20 20 20 20 | clean =| 0,.    |
|00001eb0| 20 20 20 20 4d 4f 44 49 | 46 49 45 44 20 3d 20 31 |    MODI|FIED = 1|
|00001ec0| 3b 20 20 20 20 20 20 20 | 2f 2a 20 64 69 64 20 75 |;       |/* did u|
|00001ed0| 73 65 72 20 65 78 65 63 | 75 74 65 20 d2 4d 6f 64 |ser exec|ute .Mod|
|00001ee0| 69 66 79 52 65 61 64 4f | 6e 6c 79 d3 20 6f 6e 20 |ifyReadO|nly. on |
|00001ef0| 74 68 69 73 20 66 69 6c | 65 3f 20 2a 2f 0d 20 20 |this fil|e? */.  |
|00001f00| 20 75 6e 73 69 67 6e 65 | 64 20 6c 6f 6e 67 69 6e | unsigne|d longin|
|00001f10| 74 20 55 4e 55 53 45 44 | 3b 20 2f 2a 20 6e 6f 74 |t UNUSED|; /* not|
|00001f20| 20 75 73 65 64 20 2a 2f | 0d 20 20 20 75 6e 73 69 | used */|.   unsi|
|00001f30| 67 6e 65 64 20 6c 6f 6e | 67 69 6e 74 3b 20 20 20 |gned lon|gint;   |
|00001f40| 20 20 20 20 20 2f 2a 20 | 64 61 74 65 20 61 6e 64 |     /* |date and|
|00001f50| 20 74 69 6d 65 20 6f 66 | 20 63 68 65 63 6b 6f 75 | time of| checkou|
|00001f60| 74 20 2a 2f 0d 20 20 20 | 75 6e 73 69 67 6e 65 64 |t */.   |unsigned|
|00001f70| 20 6c 6f 6e 67 69 6e 74 | 3b 20 20 20 20 20 20 20 | longint|;       |
|00001f80| 20 2f 2a 20 6d 6f 64 20 | 64 61 74 65 20 6f 66 20 | /* mod |date of |
|00001f90| 66 69 6c 65 20 2a 2f 0d | 20 20 20 75 6e 73 69 67 |file */.|   unsig|
|00001fa0| 6e 65 64 20 6c 6f 6e 67 | 69 6e 74 3b 20 20 20 20 |ned long|int;    |
|00001fb0| 20 20 20 20 2f 2a 20 50 | 49 44 2e 61 20 2a 2f 0d |    /* P|ID.a */.|
|00001fc0| 20 20 20 75 6e 73 69 67 | 6e 65 64 20 6c 6f 6e 67 |   unsig|ned long|
|00001fd0| 69 6e 74 3b 20 20 20 20 | 20 20 20 20 2f 2a 20 50 |int;    |    /* P|
|00001fe0| 49 44 2e 62 20 2a 2f 0d | 20 20 20 69 6e 74 65 67 |ID.b */.|   integ|
|00001ff0| 65 72 3b 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |er;     |        |
|00002000| 20 20 20 20 2f 2a 20 75 | 73 65 72 20 49 44 20 2a |    /* u|ser ID *|
|00002010| 2f 0d 20 20 20 69 6e 74 | 65 67 65 72 3b 20 20 20 |/.   int|eger;   |
|00002020| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 2f 2a |        |      /*|
|00002030| 20 66 69 6c 65 20 49 44 | 20 2a 2f 0d 20 20 20 69 | file ID| */.   i|
|00002040| 6e 74 65 67 65 72 3b 20 | 20 20 20 20 20 20 20 20 |nteger; |        |
|00002050| 20 20 20 20 20 20 20 20 | 2f 2a 20 72 65 76 20 49 |        |/* rev I|
|00002060| 44 20 2a 2f 0d 20 20 20 | 70 73 74 72 69 6e 67 3b |D */.   |pstring;|
|00002070| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00002080| 20 2f 2a 20 50 72 6f 6a | 65 63 74 20 70 61 74 68 | /* Proj|ect path|
|00002090| 20 2a 2f 0d 20 20 20 42 | 79 74 65 20 3d 20 30 3b | */.   B|yte = 0;|
|000020a0| 0d 20 20 20 70 73 74 72 | 69 6e 67 3b 20 20 20 20 |.   pstr|ing;    |
|000020b0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 2f 2a 20 |        |     /* |
|000020c0| 55 73 65 72 20 6e 61 6d | 65 20 2a 2f 0d 20 20 20 |User nam|e */.   |
|000020d0| 42 79 74 65 20 3d 20 30 | 3b 0d 20 20 20 70 73 74 |Byte = 0|;.   pst|
|000020e0| 72 69 6e 67 3b 20 20 20 | 20 20 20 20 20 20 20 20 |ring;   |        |
|000020f0| 20 20 20 20 20 20 2f 2a | 20 52 65 76 69 73 69 6f |      /*| Revisio|
|00002100| 6e 20 6e 75 6d 62 65 72 | 20 2a 2f 0d 20 20 20 42 |n number| */.   B|
|00002110| 79 74 65 20 3d 20 30 3b | 0d 20 20 20 70 73 74 72 |yte = 0;|.   pstr|
|00002120| 69 6e 67 3b 20 20 20 20 | 20 20 20 20 20 20 20 20 |ing;    |        |
|00002130| 20 20 20 20 20 2f 2a 20 | 46 69 6c 65 20 6e 61 6d |     /* |File nam|
|00002140| 65 20 2a 2f 0d 20 20 20 | 42 79 74 65 20 3d 20 30 |e */.   |Byte = 0|
|00002150| 3b 0d 20 20 20 70 73 74 | 72 69 6e 67 3b 20 20 20 |;.   pst|ring;   |
|00002160| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 2f 2a |        |      /*|
|00002170| 20 74 61 73 6b 20 2a 2f | 0d 20 20 20 42 79 74 65 | task */|.   Byte|
|00002180| 20 3d 20 30 3b 0d 20 20 | 20 77 73 74 72 69 6e 67 | = 0;.  | wstring|
|00002190| 3b 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |;       |        |
|000021a0| 20 20 2f 2a 20 63 6f 6d | 6d 65 6e 74 20 2a 2f 0d |  /* com|ment */.|
|000021b0| 20 20 20 42 79 74 65 20 | 3d 20 30 3b 0d 7d 3b 0d |   Byte |= 0;.};.|
|000021c0| 4e 6f 74 65 73 0d 54 68 | 65 20 62 72 61 6e 63 68 |Notes.Th|e branch|
|000021d0| 20 66 69 65 6c 64 20 28 | 66 69 65 6c 64 20 35 29 | field (|field 5)|
|000021e0| 20 68 6f 6c 64 73 20 74 | 68 65 20 6c 65 74 74 65 | holds t|he lette|
|000021f0| 72 20 6f 66 20 74 68 69 | 73 20 62 72 61 6e 63 68 |r of thi|s branch|
|00002200| 20 28 69 2e 65 2e 2c 20 | d2 61 d3 2c 20 d2 62 d3 | (i.e., |.a., .b.|
|00002210| 2c 20 d2 63 d3 2c 20 65 | 74 63 2e 29 2e 20 20 49 |, .c., e|tc.).  I|
|00002220| 74 20 68 6f 6c 64 73 20 | 7a 65 72 6f 20 69 66 20 |t holds |zero if |
|00002230| 74 68 69 73 20 72 65 76 | 69 73 69 6f 6e 20 69 73 |this rev|ision is|
|00002240| 20 6f 6e 20 74 68 65 20 | 6d 61 69 6e 20 62 72 61 | on the |main bra|
|00002250| 6e 63 68 2e 0d 50 49 44 | 20 69 73 20 74 68 65 20 |nch..PID| is the |
|00002260| 50 72 6f 6a 65 63 74 20 | 49 44 2e 20 20 49 74 20 |Project |ID.  It |
|00002270| 69 73 20 67 65 6e 65 72 | 61 74 65 64 20 75 73 69 |is gener|ated usi|
|00002280| 6e 67 20 61 20 63 6f 6d | 62 69 6e 61 74 69 6f 6e |ng a com|bination|
|00002290| 20 6f 66 20 74 68 65 20 | 74 69 63 6b 20 63 6f 75 | of the |tick cou|
|000022a0| 6e 74 20 61 6e 64 20 74 | 69 6d 65 20 6f 6e 20 79 |nt and t|ime on y|
|000022b0| 6f 75 72 20 63 6f 6d 70 | 75 74 65 72 20 69 6e 20 |our comp|uter in |
|000022c0| 61 20 77 61 79 20 74 68 | 61 74 20 73 68 6f 75 6c |a way th|at shoul|
|000022d0| 64 20 62 65 20 73 75 66 | 66 69 63 69 65 6e 74 20 |d be suf|ficient |
|000022e0| 74 6f 20 67 65 6e 65 72 | 61 74 65 20 75 6e 69 71 |to gener|ate uniq|
|000022f0| 75 65 20 50 72 6f 6a 65 | 63 74 20 49 44 73 20 66 |ue Proje|ct IDs f|
|00002300| 6f 72 20 65 76 65 72 79 | 20 70 72 6f 6a 65 63 74 |or every| project|
|00002310| 20 65 76 65 72 20 63 72 | 65 61 74 65 64 2e 0d 54 | ever cr|eated..T|
|00002320| 68 65 20 70 73 74 72 69 | 6e 67 20 61 6e 64 20 77 |he pstri|ng and w|
|00002330| 73 74 72 69 6e 67 20 66 | 69 65 6c 64 73 20 61 72 |string f|ields ar|
|00002340| 65 20 76 61 72 69 61 62 | 6c 65 20 6c 65 6e 67 74 |e variab|le lengt|
|00002350| 68 20 66 69 65 6c 64 73 | 20 28 70 73 74 72 69 6e |h fields| (pstrin|
|00002360| 67 20 69 73 20 61 20 73 | 74 72 69 6e 67 20 70 72 |g is a s|tring pr|
|00002370| 65 63 65 64 65 64 20 62 | 79 20 61 20 6c 65 6e 67 |eceded b|y a leng|
|00002380| 74 68 20 42 59 54 45 2c | 20 77 68 69 6c 65 20 77 |th BYTE,| while w|
|00002390| 73 74 72 69 6e 67 20 69 | 73 20 61 20 73 74 72 69 |string i|s a stri|
|000023a0| 6e 67 20 70 72 65 63 65 | 64 65 64 20 62 79 20 61 |ng prece|ded by a|
|000023b0| 20 6c 65 6e 67 74 68 20 | 57 4f 52 44 29 2c 20 77 | length |WORD), w|
|000023c0| 68 69 63 68 20 6d 65 61 | 6e 73 20 74 68 61 74 20 |hich mea|ns that |
|000023d0| 79 6f 75 20 63 61 6e 6e | 6f 74 20 64 69 72 65 63 |you cann|ot direc|
|000023e0| 74 6c 79 20 72 65 70 72 | 65 73 65 6e 74 20 74 68 |tly repr|esent th|
|000023f0| 69 73 20 72 65 73 6f 75 | 72 63 65 20 77 69 74 68 |is resou|rce with|
|00002400| 20 61 20 52 45 43 4f 52 | 44 20 69 6e 20 50 61 73 | a RECOR|D in Pas|
|00002410| 63 61 6c 20 6f 72 20 73 | 74 72 75 63 74 20 69 6e |cal or s|truct in|
|00002420| 20 43 2e 0d 46 75 72 74 | 68 65 72 20 52 65 66 65 | C..Furt|her Refe|
|00002430| 72 65 6e 63 65 3a 0d a5 | 09 4d 61 63 69 6e 74 6f |rence:..|.Macinto|
|00002440| 73 68 20 50 72 6f 67 72 | 61 6d 6d 65 72 d5 73 20 |sh Progr|ammer.s |
|00002450| 57 6f 72 6b 53 68 6f 70 | 20 33 2e 30 20 52 65 66 |WorkShop| 3.0 Ref|
|00002460| 65 72 65 6e 63 65 2c 20 | 43 68 61 70 74 65 72 20 |erence, |Chapter |
|00002470| 37 2c 0d 09 50 72 6f 6a | 65 63 74 6f 72 3a 20 20 |7,..Proj|ector:  |
|00002480| 50 72 6f 6a 65 63 74 20 | 4d 61 6e 61 67 65 6d 65 |Project |Manageme|
|00002490| 6e 74 0d 41 2f 52 4f 53 | 45 20 26 20 4d 43 50 20 |nt.A/ROS|E & MCP |
|000024a0| 43 61 72 64 20 51 26 41 | 73 0d 50 6c 61 74 66 6f |Card Q&A|s.Platfo|
|000024b0| 72 6d 73 20 26 20 54 6f | 6f 6c 73 09 4d 2e 50 54 |rms & To|ols.M.PT|
|000024c0| 2e 41 2f 52 4f 53 45 2e | 51 26 41 73 0d 52 65 76 |.A/ROSE.|Q&As.Rev|
|000024d0| 69 73 65 64 20 62 79 3a | 09 44 65 76 65 6c 6f 70 |ised by:|.Develop|
|000024e0| 65 72 20 53 75 70 70 6f | 72 74 20 43 65 6e 74 65 |er Suppo|rt Cente|
|000024f0| 72 09 44 65 63 65 6d 62 | 65 72 20 31 39 39 32 0d |r.Decemb|er 1992.|
|00002500| 57 72 69 74 74 65 6e 20 | 62 79 3a 09 44 65 76 65 |Written |by:.Deve|
|00002510| 6c 6f 70 65 72 20 53 75 | 70 70 6f 72 74 20 43 65 |loper Su|pport Ce|
|00002520| 6e 74 65 72 09 4f 63 74 | 6f 62 65 72 20 31 39 39 |nter.Oct|ober 199|
|00002530| 30 0d 54 68 69 73 20 54 | 65 63 68 6e 69 63 61 6c |0.This T|echnical|
|00002540| 20 4e 6f 74 65 20 63 6f | 6e 74 61 69 6e 73 20 61 | Note co|ntains a|
|00002550| 20 63 6f 6c 6c 65 63 74 | 69 6f 6e 20 6f 66 20 51 | collect|ion of Q|
|00002560| 26 41 73 20 72 65 6c 61 | 74 69 6e 67 20 74 6f 20 |&As rela|ting to |
|00002570| 61 20 73 70 65 63 69 66 | 69 63 20 74 6f 70 69 63 |a specif|ic topic|
|00002580| d1 71 75 65 73 74 69 6f | 6e 73 20 79 6f 75 d5 76 |.questio|ns you.v|
|00002590| 65 20 73 65 6e 74 20 74 | 68 65 20 44 65 76 65 6c |e sent t|he Devel|
|000025a0| 6f 70 65 72 20 53 75 70 | 70 6f 72 74 20 43 65 6e |oper Sup|port Cen|
|000025b0| 74 65 72 20 28 44 53 43 | 29 20 61 6c 6f 6e 67 20 |ter (DSC|) along |
|000025c0| 77 69 74 68 20 61 6e 73 | 77 65 72 73 20 66 72 6f |with ans|wers fro|
|000025d0| 6d 20 74 68 65 20 44 53 | 43 20 65 6e 67 69 6e 65 |m the DS|C engine|
|000025e0| 65 72 73 2e 20 57 68 69 | 6c 65 20 44 53 43 20 65 |ers. Whi|le DSC e|
|000025f0| 6e 67 69 6e 65 65 72 73 | 20 68 61 76 65 20 63 68 |ngineers| have ch|
|00002600| 65 63 6b 65 64 20 74 68 | 65 20 51 26 41 20 63 6f |ecked th|e Q&A co|
|00002610| 6e 74 65 6e 74 20 66 6f | 72 20 61 63 63 75 72 61 |ntent fo|r accura|
|00002620| 63 79 2c 20 74 68 65 20 | 51 26 41 20 54 65 63 68 |cy, the |Q&A Tech|
|00002630| 6e 69 63 61 6c 20 4e 6f | 74 65 73 20 64 6f 6e d5 |nical No|tes don.|
|00002640| 74 20 68 61 76 65 20 74 | 68 65 20 65 64 69 74 69 |t have t|he editi|
|00002650| 6e 67 20 61 6e 64 20 6f | 72 67 61 6e 69 7a 61 74 |ng and o|rganizat|
|00002660| 69 6f 6e 20 6f 66 20 6f | 74 68 65 72 20 54 65 63 |ion of o|ther Tec|
|00002670| 68 6e 69 63 61 6c 20 4e | 6f 74 65 73 2e 20 54 68 |hnical N|otes. Th|
|00002680| 65 20 51 26 41 20 66 75 | 6e 63 74 69 6f 6e 20 69 |e Q&A fu|nction i|
|00002690| 73 20 74 6f 20 67 65 74 | 20 6e 65 77 20 74 65 63 |s to get| new tec|
|000026a0| 68 6e 69 63 61 6c 20 69 | 6e 66 6f 72 6d 61 74 69 |hnical i|nformati|
|000026b0| 6f 6e 20 61 6e 64 20 75 | 70 64 61 74 65 73 20 74 |on and u|pdates t|
|000026c0| 6f 20 79 6f 75 20 71 75 | 69 63 6b 6c 79 2c 20 73 |o you qu|ickly, s|
|000026d0| 61 76 69 6e 67 20 74 68 | 65 20 70 6f 6c 69 73 68 |aving th|e polish|
|000026e0| 20 66 6f 72 20 77 68 65 | 6e 20 74 68 65 20 69 6e | for whe|n the in|
|000026f0| 66 6f 72 6d 61 74 69 6f | 6e 20 6d 69 67 72 61 74 |formatio|n migrat|
|00002700| 65 73 20 69 6e 74 6f 20 | 72 65 66 65 72 65 6e 63 |es into |referenc|
|00002710| 65 20 6d 61 6e 75 61 6c | 73 2e 0d 51 26 41 73 20 |e manual|s..Q&As |
|00002720| 61 72 65 20 6e 6f 77 20 | 69 6e 63 6c 75 64 65 64 |are now |included|
|00002730| 20 77 69 74 68 20 54 65 | 63 68 6e 69 63 61 6c 20 | with Te|chnical |
|00002740| 4e 6f 74 65 73 20 74 6f | 20 6d 61 6b 65 20 61 63 |Notes to| make ac|
|00002750| 63 65 73 73 20 74 6f 20 | 74 65 63 68 6e 69 63 61 |cess to |technica|
|00002760| 6c 20 75 70 64 61 74 65 | 73 20 65 61 73 69 65 72 |l update|s easier|
|00002770| 20 66 6f 72 20 79 6f 75 | 2e 20 49 66 20 79 6f 75 | for you|. If you|
|00002780| 20 68 61 76 65 20 63 6f | 6d 6d 65 6e 74 73 20 6f | have co|mments o|
|00002790| 72 20 73 75 67 67 65 73 | 74 69 6f 6e 73 20 61 62 |r sugges|tions ab|
|000027a0| 6f 75 74 20 51 26 41 20 | 63 6f 6e 74 65 6e 74 20 |out Q&A |content |
|000027b0| 6f 72 20 64 69 73 74 72 | 69 62 75 74 69 6f 6e 2c |or distr|ibution,|
|000027c0| 20 70 6c 65 61 73 65 20 | 6c 65 74 20 75 73 20 6b | please |let us k|
|000027d0| 6e 6f 77 20 62 79 20 73 | 65 6e 64 69 6e 67 20 61 |now by s|ending a|
|000027e0| 6e 20 41 70 70 6c 65 4c | 69 6e 6b 20 74 6f 20 44 |n AppleL|ink to D|
|000027f0| 45 56 46 45 45 44 42 41 | 43 4b 2e 20 41 70 70 6c |EVFEEDBA|CK. Appl|
|00002800| 65 20 50 61 72 74 6e 65 | 72 73 20 6d 61 79 20 73 |e Partne|rs may s|
|00002810| 65 6e 64 20 74 65 63 68 | 6e 69 63 61 6c 20 71 75 |end tech|nical qu|
|00002820| 65 73 74 69 6f 6e 73 20 | 61 62 6f 75 74 20 51 26 |estions |about Q&|
|00002830| 41 20 63 6f 6e 74 65 6e | 74 20 74 6f 20 44 45 56 |A conten|t to DEV|
|00002840| 53 55 50 50 4f 52 54 20 | 66 6f 72 20 72 65 73 6f |SUPPORT |for reso|
|00002850| 6c 75 74 69 6f 6e 2e 0d | 41 2f 52 4f 53 45 20 26 |lution..|A/ROSE &|
|00002860| 20 4d 43 50 20 64 65 76 | 65 6c 6f 70 6d 65 6e 74 | MCP dev|elopment|
|00002870| 20 71 75 65 73 74 69 6f | 6e 73 0d 57 72 69 74 74 | questio|ns.Writt|
|00002880| 65 6e 3a 09 31 32 2f 31 | 31 2f 39 30 0d 4c 61 73 |en:.12/1|1/90.Las|
|00002890| 74 20 72 65 76 69 65 77 | 65 64 3a 09 38 2f 31 39 |t review|ed:.8/19|
|000028a0| 2f 39 32 0d 57 68 61 74 | 20 72 65 73 74 72 69 63 |/92.What| restric|
|000028b0| 74 69 6f 6e 73 20 28 70 | 6f 77 65 72 2c 20 73 70 |tions (p|ower, sp|
|000028c0| 65 65 64 2c 20 61 6e 64 | 20 73 6f 20 6f 6e 29 20 |eed, and| so on) |
|000028d0| 64 6f 65 73 20 74 68 65 | 20 4d 61 63 69 6e 74 6f |does the| Macinto|
|000028e0| 73 68 20 43 6f 70 72 6f | 63 65 73 73 6f 72 20 50 |sh Copro|cessor P|
|000028f0| 6c 61 74 66 6f 72 6d 20 | 28 4d 43 50 29 20 69 6d |latform |(MCP) im|
|00002900| 70 6f 73 65 20 6f 6e 20 | 74 68 65 20 68 61 72 64 |pose on |the hard|
|00002910| 77 61 72 65 20 61 64 64 | 65 64 20 74 6f 20 74 68 |ware add|ed to th|
|00002920| 65 20 70 6c 61 74 66 6f | 72 6d 3f 20 43 61 6e 20 |e platfo|rm? Can |
|00002930| 77 65 20 75 73 65 20 41 | 2f 52 4f 53 45 20 6f 6e |we use A|/ROSE on|
|00002940| 20 61 20 62 6f 61 72 64 | 20 74 68 61 74 20 77 65 | a board| that we|
|00002950| 20 64 65 73 69 67 6e 20 | 6f 75 72 73 65 6c 76 65 | design |ourselve|
|00002960| 73 20 66 72 6f 6d 20 73 | 63 72 61 74 63 68 3f 20 |s from s|cratch? |
|00002970| 49 66 20 73 6f 2c 20 77 | 65 20 68 61 76 65 20 74 |If so, w|e have t|
|00002980| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 71 75 65 |he follo|wing que|
|00002990| 73 74 69 6f 6e 73 20 63 | 6f 6e 63 65 72 6e 69 6e |stions c|oncernin|
|000029a0| 67 20 74 68 65 20 68 61 | 72 64 77 61 72 65 20 72 |g the ha|rdware r|
|000029b0| 65 71 75 69 72 65 6d 65 | 6e 74 73 20 66 6f 72 20 |equireme|nts for |
|000029c0| 61 20 62 6f 61 72 64 20 | 72 75 6e 6e 69 6e 67 20 |a board |running |
|000029d0| 41 2f 52 4f 53 45 3a 20 | 4d 75 73 74 20 74 68 65 |A/ROSE: |Must the|
|000029e0| 20 43 50 55 20 72 75 6e | 6e 69 6e 67 20 41 2f 52 | CPU run|ning A/R|
|000029f0| 4f 53 45 20 62 65 20 61 | 20 36 38 30 30 30 20 6f |OSE be a| 68000 o|
|00002a00| 72 20 63 6f 75 6c 64 20 | 69 74 20 62 65 20 61 20 |r could |it be a |
|00002a10| 36 38 30 32 30 20 6f 72 | 20 36 38 30 33 30 3f 20 |68020 or| 68030? |
|00002a20| 43 61 6e 20 41 2f 52 4f | 53 45 20 68 61 6e 64 6c |Can A/RO|SE handl|
|00002a30| 65 20 6d 61 73 74 65 72 | 20 74 72 61 6e 73 66 65 |e master| transfe|
|00002a40| 72 73 20 75 6e 64 65 72 | 20 4e 75 42 75 73 20 63 |rs under| NuBus c|
|00002a50| 6f 6e 74 72 6f 6c 20 62 | 65 74 77 65 65 6e 20 74 |ontrol b|etween t|
|00002a60| 68 65 20 63 61 72 64 20 | 61 6e 64 20 6d 61 69 6e |he card |and main|
|00002a70| 20 62 6f 61 72 64 20 6d | 65 6d 6f 72 79 3f 20 49 | board m|emory? I|
|00002a80| 73 20 74 68 65 20 73 6f | 75 72 63 65 20 63 6f 64 |s the so|urce cod|
|00002a90| 65 20 66 6f 72 20 41 2f | 52 4f 53 45 20 28 61 6e |e for A/|ROSE (an|
|00002aa0| 64 20 73 70 65 63 69 66 | 69 63 61 6c 6c 79 20 74 |d specif|ically t|
|00002ab0| 68 65 20 49 6e 74 65 72 | 43 61 72 64 20 43 6f 6d |he Inter|Card Com|
|00002ac0| 6d 75 6e 69 63 61 74 69 | 6f 6e 20 4d 61 6e 61 67 |municati|on Manag|
|00002ad0| 65 72 29 20 61 76 61 69 | 6c 61 62 6c 65 20 69 66 |er) avai|lable if|
|00002ae0| 20 77 65 20 6e 65 65 64 | 65 64 20 74 6f 20 74 61 | we need|ed to ta|
|00002af0| 69 6c 6f 72 20 74 68 61 | 74 20 63 6f 64 65 20 74 |ilor tha|t code t|
|00002b00| 6f 20 6f 75 72 20 73 79 | 73 74 65 6d 3f 0d 5f 5f |o our sy|stem?.__|
|00002b10| 5f 0d 54 6f 20 74 68 65 | 20 6b 6e 6f 77 6c 65 64 |_.To the| knowled|
|00002b20| 67 65 20 6f 66 20 74 68 | 65 20 41 2f 52 4f 53 45 |ge of th|e A/ROSE|
|00002b30| 20 65 6e 67 69 6e 65 65 | 72 2c 20 41 2f 52 4f 53 | enginee|r, A/ROS|
|00002b40| 45 20 72 65 71 75 69 72 | 65 73 20 6d 6f 64 69 66 |E requir|es modif|
|00002b50| 69 63 61 74 69 6f 6e 20 | 69 6e 20 6f 72 64 65 72 |ication |in order|
|00002b60| 20 74 6f 20 70 65 72 6d | 69 74 20 6d 61 73 74 65 | to perm|it maste|
|00002b70| 72 20 74 72 61 6e 73 66 | 65 72 73 20 75 6e 64 65 |r transf|ers unde|
|00002b80| 72 20 4e 75 42 75 73 20 | 63 6f 6e 74 72 6f 6c 20 |r NuBus |control |
|00002b90| 62 65 74 77 65 65 6e 20 | 74 68 65 20 63 61 72 64 |between |the card|
|00002ba0| 20 61 6e 64 20 6d 61 69 | 6e 20 62 6f 61 72 64 20 | and mai|n board |
|00002bb0| 6d 65 6d 6f 72 79 2e 20 | 54 68 65 20 65 6e 67 69 |memory. |The engi|
|00002bc0| 6e 65 65 72 20 73 75 63 | 63 65 65 64 65 64 20 69 |neer suc|ceeded i|
|00002bd0| 6e 20 64 65 73 69 67 6e | 69 6e 67 20 61 20 72 6f |n design|ing a ro|
|00002be0| 75 74 69 6e 65 20 74 6f | 20 70 65 72 66 6f 72 6d |utine to| perform|
|00002bf0| 20 74 68 65 20 77 72 69 | 74 65 20 6f 70 65 72 61 | the wri|te opera|
|00002c00| 74 69 6f 6e 20 66 72 6f | 6d 20 41 2f 52 4f 53 45 |tion fro|m A/ROSE|
|00002c10| 3b 20 68 6f 77 65 76 65 | 72 2c 20 74 68 65 20 72 |; howeve|r, the r|
|00002c20| 65 61 64 20 6f 70 65 72 | 61 74 69 6f 6e 20 70 72 |ead oper|ation pr|
|00002c30| 6f 76 65 64 20 74 6f 20 | 62 65 20 61 20 63 68 61 |oved to |be a cha|
|00002c40| 6c 6c 65 6e 67 65 2e 20 | 41 20 73 6f 6c 75 74 69 |llenge. |A soluti|
|00002c50| 6f 6e 20 74 6f 20 79 6f | 75 72 20 70 72 6f 62 6c |on to yo|ur probl|
|00002c60| 65 6d 20 77 6f 75 6c 64 | 20 62 65 20 74 6f 20 72 |em would| be to r|
|00002c70| 65 6c 65 61 73 65 20 74 | 68 65 20 73 6f 75 72 63 |elease t|he sourc|
|00002c80| 65 20 63 6f 64 65 2e 20 | 48 6f 77 65 76 65 72 2c |e code. |However,|
|00002c90| 20 61 74 20 74 68 69 73 | 20 74 69 6d 65 20 74 68 | at this| time th|
|00002ca0| 69 73 20 69 73 6e d5 74 | 20 70 6f 73 73 69 62 6c |is isn.t| possibl|
|00002cb0| 65 2e 20 54 68 65 72 65 | 20 68 61 73 20 62 65 65 |e. There| has bee|
|00002cc0| 6e 20 63 6f 6e 73 69 64 | 65 72 61 74 69 6f 6e 20 |n consid|eration |
|00002cd0| 6f 6e 20 74 68 69 73 20 | 73 75 62 6a 65 63 74 20 |on this |subject |
|00002ce0| 62 75 74 20 6e 6f 20 66 | 69 6e 61 6c 20 64 65 63 |but no f|inal dec|
|00002cf0| 69 73 69 6f 6e 2e 0d 49 | 6e 20 72 65 73 70 6f 6e |ision..I|n respon|
|00002d00| 73 65 20 74 6f 20 79 6f | 75 72 20 6f 74 68 65 72 |se to yo|ur other|
|00002d10| 20 71 75 65 73 74 69 6f | 6e 73 2c 20 4d 43 50 20 | questio|ns, MCP |
|00002d20| 64 6f 65 73 6e d5 74 20 | 69 6d 70 6f 73 65 20 61 |doesn.t |impose a|
|00002d30| 6e 79 20 72 65 73 74 72 | 69 63 74 69 6f 6e 73 20 |ny restr|ictions |
|00002d40| 6f 6e 20 74 68 65 20 68 | 61 72 64 77 61 72 65 2e |on the h|ardware.|
|00002d50| 20 54 68 65 72 65 20 61 | 72 65 20 73 6f 6d 65 20 | There a|re some |
|00002d60| 63 61 72 64 20 64 65 70 | 65 6e 64 65 6e 63 69 65 |card dep|endencie|
|00002d70| 73 20 69 6d 70 6f 73 65 | 64 20 62 79 20 41 2f 52 |s impose|d by A/R|
|00002d80| 4f 53 45 2c 20 64 65 73 | 63 72 69 62 65 64 20 69 |OSE, des|cribed i|
|00002d90| 6e 20 74 68 65 20 64 6f | 63 75 6d 65 6e 74 2c 20 |n the do|cument, |
|00002da0| d2 41 2f 52 4f 53 45 20 | 43 61 72 64 20 44 65 70 |.A/ROSE |Card Dep|
|00002db0| 65 6e 64 65 6e 63 79 2c | d3 20 61 76 61 69 6c 61 |endency,|. availa|
|00002dc0| 62 6c 65 20 6f 6e 20 41 | 70 70 6c 65 4c 69 6e 6b |ble on A|ppleLink|
|00002dd0| 2e 0d 49 d5 6d 20 66 61 | 6d 69 6c 69 61 72 20 77 |..I.m fa|miliar w|
|00002de0| 69 74 68 20 61 20 63 6f | 75 70 6c 65 20 6f 66 20 |ith a co|uple of |
|00002df0| 63 61 72 64 73 20 62 61 | 73 65 64 20 6f 6e 20 74 |cards ba|sed on t|
|00002e00| 68 65 20 4d 43 50 20 62 | 6f 61 72 64 2e 20 4f 6e |he MCP b|oard. On|
|00002e10| 20 6f 6e 65 20 63 61 72 | 64 20 69 6e 20 70 61 72 | one car|d in par|
|00002e20| 74 69 63 75 6c 61 72 2c | 20 74 68 65 20 70 72 6f |ticular,| the pro|
|00002e30| 63 65 73 73 6f 72 20 77 | 61 73 20 73 77 61 70 70 |cessor w|as swapp|
|00002e40| 65 64 20 77 69 74 68 20 | 61 20 36 38 30 32 30 20 |ed with |a 68020 |
|00002e50| 75 73 69 6e 67 20 41 2f | 52 4f 53 45 2e 0d 41 2f |using A/|ROSE..A/|
|00002e60| 52 4f 53 45 20 26 20 4d | 43 50 20 63 61 72 64 20 |ROSE & M|CP card |
|00002e70| 66 6f 72 20 72 65 61 6c | 2d 74 69 6d 65 20 70 72 |for real|-time pr|
|00002e80| 69 6f 72 69 74 79 20 6d | 75 6c 74 69 74 61 73 6b |iority m|ultitask|
|00002e90| 69 6e 67 0d 57 72 69 74 | 74 65 6e 3a 09 31 32 2f |ing.Writ|ten:.12/|
|00002ea0| 31 30 2f 39 30 0d 4c 61 | 73 74 20 72 65 76 69 65 |10/90.La|st revie|
|00002eb0| 77 65 64 3a 09 38 2f 31 | 39 2f 39 32 0d 4f 75 72 |wed:.8/1|9/92.Our|
|00002ec0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 63 6f 6d | applica|tion com|
|00002ed0| 6d 75 6e 69 63 61 74 65 | 73 20 76 69 61 20 73 65 |municate|s via se|
|00002ee0| 72 69 61 6c 20 49 2f 4f | 20 77 69 74 68 20 72 65 |rial I/O| with re|
|00002ef0| 61 6c 2d 74 69 6d 65 20 | 64 65 76 69 63 65 73 20 |al-time |devices |
|00002f00| 69 6e 20 74 68 65 20 66 | 69 65 6c 64 2e 20 53 6f |in the f|ield. So|
|00002f10| 6d 65 20 66 75 6e 63 74 | 69 6f 6e 73 20 6f 66 20 |me funct|ions of |
|00002f20| 6f 75 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |our appl|ication |
|00002f30| 6d 75 73 74 20 72 75 6e | 20 61 74 20 61 20 68 69 |must run| at a hi|
|00002f40| 67 68 65 72 20 d2 70 72 | 69 6f 72 69 74 79 d3 20 |gher .pr|iority. |
|00002f50| 74 68 61 6e 20 61 6e 79 | 74 68 69 6e 67 20 65 6c |than any|thing el|
|00002f60| 73 65 20 6f 6e 20 74 68 | 65 20 4d 61 63 69 6e 74 |se on th|e Macint|
|00002f70| 6f 73 68 2c 20 65 76 65 | 6e 20 69 66 20 61 20 4d |osh, eve|n if a M|
|00002f80| 75 6c 74 69 46 69 6e 64 | 65 72 2d 68 6f 73 74 69 |ultiFind|er-hosti|
|00002f90| 6c 65 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 20 74 |le appli|cation t|
|00002fa0| 61 6b 65 73 20 6f 76 65 | 72 20 74 68 65 20 43 50 |akes ove|r the CP|
|00002fb0| 55 20 74 6f 20 64 6f 20 | 61 6e 69 6d 61 74 69 6f |U to do |animatio|
|00002fc0| 6e 20 6f 72 20 77 68 61 | 74 65 76 65 72 2e 20 4f |n or wha|tever. O|
|00002fd0| 75 72 20 69 6e 69 74 69 | 61 6c 20 61 70 70 72 6f |ur initi|al appro|
|00002fe0| 61 63 68 20 69 73 20 74 | 6f 20 70 65 72 66 6f 72 |ach is t|o perfor|
|00002ff0| 6d 20 74 68 65 73 65 20 | 63 72 69 74 69 63 61 6c |m these |critical|
|00003000| 20 66 75 6e 63 74 69 6f | 6e 73 20 61 74 20 69 6f | functio|ns at io|
|00003010| 43 6f 6d 70 6c 65 74 69 | 6f 6e 20 28 69 6e 74 65 |Completi|on (inte|
|00003020| 72 72 75 70 74 29 20 74 | 69 6d 65 2c 20 62 75 74 |rrupt) t|ime, but|
|00003030| 20 74 68 69 73 20 69 73 | 20 61 20 72 6f 79 61 6c | this is| a royal|
|00003040| 20 70 61 69 6e 20 69 6e | 20 74 68 65 20 6e 65 63 | pain in| the nec|
|00003050| 6b 20 74 6f 20 69 6d 70 | 6c 65 6d 65 6e 74 2e 20 |k to imp|lement. |
|00003060| 57 65 d5 64 20 72 61 74 | 68 65 72 20 6e 6f 74 20 |We.d rat|her not |
|00003070| 72 65 71 75 69 72 65 20 | 41 2f 55 58 20 62 65 63 |require |A/UX bec|
|00003080| 61 75 73 65 20 69 74 20 | 69 6e 63 72 65 61 73 65 |ause it |increase|
|00003090| 73 20 74 68 65 20 70 72 | 69 63 65 20 61 6e 64 20 |s the pr|ice and |
|000030a0| 63 6f 6d 70 6c 65 78 69 | 74 79 20 6f 66 20 6f 75 |complexi|ty of ou|
|000030b0| 72 20 73 79 73 74 65 6d | 2e 20 57 68 61 74 d5 73 |r system|. What.s|
|000030c0| 20 74 68 65 20 62 65 73 | 74 20 77 61 79 20 74 6f | the bes|t way to|
|000030d0| 20 6d 61 6b 65 20 69 74 | 20 61 6c 6c 20 68 61 6e | make it| all han|
|000030e0| 67 20 74 6f 67 65 74 68 | 65 72 3f 0d 5f 5f 5f 0d |g togeth|er?.___.|
|000030f0| 54 68 65 20 4d 61 63 69 | 6e 74 6f 73 68 2c 20 62 |The Maci|ntosh, b|
|00003100| 79 20 69 74 73 65 6c 66 | 2c 20 69 73 20 6e 6f 74 |y itself|, is not|
|00003110| 20 61 20 76 61 6c 69 64 | 20 70 6c 61 74 66 6f 72 | a valid| platfor|
|00003120| 6d 20 66 6f 72 20 72 65 | 61 6c 2d 74 69 6d 65 20 |m for re|al-time |
|00003130| 70 72 6f 63 65 73 73 65 | 73 20 6f 72 20 70 72 69 |processe|s or pri|
|00003140| 6f 72 69 74 79 20 6d 75 | 6c 74 69 74 61 73 6b 69 |ority mu|ltitaski|
|00003150| 6e 67 2e 20 41 2f 52 4f | 53 45 20 28 41 70 70 6c |ng. A/RO|SE (Appl|
|00003160| 65 2f 52 65 61 6c 2d 74 | 69 6d 65 20 4f 70 65 72 |e/Real-t|ime Oper|
|00003170| 61 74 69 6e 67 20 53 79 | 73 74 65 6d 20 45 6e 76 |ating Sy|stem Env|
|00003180| 69 72 6f 6e 6d 65 6e 74 | 29 20 77 68 69 63 68 20 |ironment|) which |
|00003190| 72 75 6e 73 20 63 6f 6e | 63 75 72 72 65 6e 74 20 |runs con|current |
|000031a0| 70 72 69 6f 72 69 74 69 | 7a 65 64 20 70 72 6f 63 |prioriti|zed proc|
|000031b0| 65 73 73 65 73 20 6f 6e | 20 63 6f 6d 70 61 74 69 |esses on| compati|
|000031c0| 62 6c 65 20 63 6f 70 72 | 6f 63 65 73 73 6f 72 20 |ble copr|ocessor |
|000031d0| 4e 75 42 75 73 20 63 61 | 72 64 73 2c 20 73 68 6f |NuBus ca|rds, sho|
|000031e0| 75 6c 64 20 66 69 74 20 | 79 6f 75 72 20 6e 65 65 |uld fit |your nee|
|000031f0| 64 73 20 6e 69 63 65 6c | 79 2e 0d 41 2f 52 4f 53 |ds nicel|y..A/ROS|
|00003200| 45 20 72 75 6e 73 20 61 | 73 20 61 20 64 72 69 76 |E runs a|s a driv|
|00003210| 65 72 20 75 6e 64 65 72 | 20 74 68 65 20 73 74 61 |er under| the sta|
|00003220| 6e 64 61 72 64 20 4d 61 | 63 69 6e 74 6f 73 68 20 |ndard Ma|cintosh |
|00003230| 6f 70 65 72 61 74 69 6e | 67 20 73 79 73 74 65 6d |operatin|g system|
|00003240| 2e 20 49 74 20 64 6f 77 | 6e 6c 6f 61 64 73 2c 20 |. It dow|nloads, |
|00003250| 73 74 61 72 74 73 2c 20 | 73 74 6f 70 73 2c 20 73 |starts, |stops, s|
|00003260| 65 74 73 20 70 72 69 6f | 72 69 74 69 65 73 2c 20 |ets prio|rities, |
|00003270| 61 6e 64 20 63 6f 6d 6d | 75 6e 69 63 61 74 65 73 |and comm|unicates|
|00003280| 20 77 69 74 68 20 72 65 | 61 6c 2d 74 69 6d 65 20 | with re|al-time |
|00003290| 70 72 6f 63 65 73 73 65 | 73 20 74 68 61 74 20 72 |processe|s that r|
|000032a0| 75 6e 20 6f 6e 20 61 6e | 79 20 41 2f 52 4f 53 45 |un on an|y A/ROSE|
|000032b0| 20 63 6f 6d 70 61 74 69 | 62 6c 65 20 4e 75 42 75 | compati|ble NuBu|
|000032c0| 73 20 63 61 72 64 2e 20 | 54 68 65 20 41 70 70 6c |s card. |The Appl|
|000032d0| 65 20 4d 61 63 69 6e 74 | 6f 73 68 20 43 6f 70 72 |e Macint|osh Copr|
|000032e0| 6f 63 65 73 73 6f 72 20 | 50 6c 61 74 66 6f 72 6d |ocessor |Platform|
|000032f0| 20 28 4d 43 50 29 20 63 | 61 72 64 20 69 73 20 61 | (MCP) c|ard is a|
|00003300| 76 61 69 6c 61 62 6c 65 | 20 66 72 6f 6d 20 41 50 |vailable| from AP|
|00003310| 44 41 20 28 4d 61 63 69 | 6e 74 6f 73 68 20 43 6f |DA (Maci|ntosh Co|
|00003320| 70 72 6f 63 65 73 73 6f | 72 20 50 6c 61 74 66 6f |processo|r Platfo|
|00003330| 72 6d 20 44 65 76 65 6c | 6f 70 65 72 73 20 4b 69 |rm Devel|opers Ki|
|00003340| 74 20 23 4d 30 37 39 33 | 4c 4c 2f 41 29 20 61 6e |t #M0793|LL/A) an|
|00003350| 64 20 70 72 6f 76 69 64 | 65 73 20 79 6f 75 20 77 |d provid|es you w|
|00003360| 69 74 68 20 61 6e 20 4d | 43 50 20 63 61 72 64 2c |ith an M|CP card,|
|00003370| 20 41 2f 52 4f 53 45 2c | 20 41 2f 52 4f 53 45 20 | A/ROSE,| A/ROSE |
|00003380| 64 6f 63 75 6d 65 6e 74 | 61 74 69 6f 6e 2c 20 61 |document|ation, a|
|00003390| 6e 64 20 64 65 76 65 6c | 6f 70 6d 65 6e 74 20 69 |nd devel|opment i|
|000033a0| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 6f 6e 20 68 6f |nformati|on on ho|
|000033b0| 77 20 74 6f 20 64 65 73 | 69 67 6e 20 79 6f 75 72 |w to des|ign your|
|000033c0| 20 6f 77 6e 20 28 69 66 | 20 79 6f 75 20 70 72 65 | own (if| you pre|
|000033d0| 66 65 72 29 20 63 6f 70 | 72 6f 63 65 73 73 6f 72 |fer) cop|rocessor|
|000033e0| 20 63 61 72 64 2e 20 54 | 68 65 72 65 20 69 73 20 | card. T|here is |
|000033f0| 61 6c 73 6f 20 61 6e 20 | 65 78 63 65 6c 6c 65 6e |also an |excellen|
|00003400| 74 20 61 72 74 69 63 6c | 65 20 69 6e 20 64 65 76 |t articl|e in dev|
|00003410| 65 6c 6f 70 20 23 34 20 | 6f 6e 20 64 65 76 65 6c |elop #4 |on devel|
|00003420| 6f 70 69 6e 67 20 77 69 | 74 68 20 41 2f 52 4f 53 |oping wi|th A/ROS|
|00003430| 45 20 61 6e 64 20 4d 43 | 50 2e 0d 41 6e 20 61 6c |E and MC|P..An al|
|00003440| 74 65 72 6e 61 74 69 76 | 65 20 64 65 76 65 6c 6f |ternativ|e develo|
|00003450| 70 6d 65 6e 74 20 65 6e | 76 69 72 6f 6e 6d 65 6e |pment en|vironmen|
|00003460| 74 20 66 6f 72 20 72 65 | 61 6c 2d 74 69 6d 65 20 |t for re|al-time |
|00003470| 70 72 6f 67 72 61 6d 6d | 69 6e 67 20 77 6f 75 6c |programm|ing woul|
|00003480| 64 20 62 65 20 74 6f 20 | 6c 69 63 65 6e 73 65 20 |d be to |license |
|00003490| 61 6e 64 20 64 65 76 65 | 6c 6f 70 20 79 6f 75 72 |and deve|lop your|
|000034a0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 75 6e 64 | applica|tion und|
|000034b0| 65 72 20 41 2f 55 58 20 | 6f 6e 20 74 68 65 20 4d |er A/UX |on the M|
|000034c0| 61 63 69 6e 74 6f 73 68 | 2e 0d 49 20 77 6f 75 6c |acintosh|..I woul|
|000034d0| 64 20 6e 6f 74 20 73 75 | 67 67 65 73 74 20 74 72 |d not su|ggest tr|
|000034e0| 79 69 6e 67 20 74 6f 20 | d2 74 6f 75 67 68 20 69 |ying to |.tough i|
|000034f0| 74 20 6f 75 74 d3 20 61 | 74 20 69 6e 74 65 72 72 |t out. a|t interr|
|00003500| 75 70 74 20 6c 65 76 65 | 6c 20 61 73 20 74 68 69 |upt leve|l as thi|
|00003510| 73 20 77 69 6c 6c 20 70 | 75 74 20 79 6f 75 20 61 |s will p|ut you a|
|00003520| 74 20 6f 64 64 73 20 77 | 69 74 68 20 74 68 65 20 |t odds w|ith the |
|00003530| 77 61 79 20 74 68 65 20 | 4d 61 63 69 6e 74 6f 73 |way the |Macintos|
|00003540| 68 20 6f 70 65 72 61 74 | 65 73 3b 20 61 63 63 52 |h operat|es; accR|
|00003550| 75 6e 20 74 69 6d 65 20 | 77 69 6c 6c 20 6e 65 76 |un time |will nev|
|00003560| 65 72 20 70 72 6f 76 69 | 64 65 20 79 6f 75 20 77 |er provi|de you w|
|00003570| 69 74 68 20 d2 70 72 69 | 6f 72 69 74 79 d3 20 72 |ith .pri|ority. r|
|00003580| 75 6e 20 74 69 6d 65 2c | 20 6f 6e 6c 79 20 74 69 |un time,| only ti|
|00003590| 6d 65 20 74 68 61 74 20 | 69 73 20 6f 74 68 65 72 |me that |is other|
|000035a0| 77 69 73 65 20 61 76 61 | 69 6c 61 62 6c 65 2e 20 |wise ava|ilable. |
|000035b0| 50 61 74 63 68 69 6e 67 | 20 53 74 69 6c 6c 44 6f |Patching| StillDo|
|000035c0| 77 6e 20 69 73 20 6a 75 | 73 74 20 6e 6f 74 20 61 |wn is ju|st not a|
|000035d0| 20 73 75 70 70 6f 72 74 | 61 62 6c 65 20 6f 70 74 | support|able opt|
|000035e0| 69 6f 6e 2e 20 57 65 72 | 65 20 49 20 61 74 74 65 |ion. Wer|e I atte|
|000035f0| 6d 70 74 69 6e 67 20 74 | 68 69 73 20 70 72 6f 6a |mpting t|his proj|
|00003600| 65 63 74 20 49 20 77 6f | 75 6c 64 20 68 65 61 64 |ect I wo|uld head|
|00003610| 20 73 74 72 61 69 67 68 | 74 20 66 6f 72 20 41 2f | straigh|t for A/|
|00003620| 52 4f 53 45 20 61 6e 64 | 20 72 75 6e 20 69 74 20 |ROSE and| run it |
|00003630| 6f 6e 20 65 69 74 68 65 | 72 20 74 68 65 20 41 70 |on eithe|r the Ap|
|00003640| 70 6c 65 20 53 65 72 69 | 61 6c 20 4e 42 20 63 61 |ple Seri|al NB ca|
|00003650| 72 64 20 28 41 2f 52 4f | 53 45 2d 63 6f 6d 70 61 |rd (A/RO|SE-compa|
|00003660| 74 69 62 6c 65 20 77 69 | 74 68 20 6f 6e 2d 62 6f |tible wi|th on-bo|
|00003670| 61 72 64 20 31 30 20 4d | 48 7a 20 36 38 30 30 30 |ard 10 M|Hz 68000|
|00003680| 20 61 6e 64 20 34 20 64 | 65 64 69 63 61 74 65 64 | and 4 d|edicated|
|00003690| 20 73 65 72 69 61 6c 20 | 70 6f 72 74 73 29 20 6f | serial |ports) o|
|000036a0| 72 20 64 65 73 69 67 6e | 20 6d 79 20 6f 77 6e 20 |r design| my own |
|000036b0| 73 65 72 69 61 6c 20 68 | 61 72 64 77 61 72 65 20 |serial h|ardware |
|000036c0| 6f 6e 20 74 68 65 20 4d | 43 50 20 63 61 72 64 2e |on the M|CP card.|
|000036d0| 0d 58 2d 52 65 66 3a 0d | d2 49 6e 73 69 64 65 20 |.X-Ref:.|.Inside |
|000036e0| 74 68 65 20 4d 61 63 69 | 6e 74 6f 73 68 20 43 6f |the Maci|ntosh Co|
|000036f0| 70 72 6f 63 65 73 73 6f | 72 20 50 6c 61 74 66 6f |processo|r Platfo|
|00003700| 72 6d 20 61 6e 64 20 41 | 2f 52 4f 53 45 2c d3 20 |rm and A|/ROSE,. |
|00003710| 64 65 76 65 6c 6f 70 2c | 20 49 73 73 75 65 20 34 |develop,| Issue 4|
|00003720| 2c 20 4f 63 74 20 39 30 | 0d 67 43 6f 6d 6d 6f 6e |, Oct 90|.gCommon|
|00003730| 20 61 64 64 72 65 73 73 | 65 73 20 61 6e 64 20 64 | address|es and d|
|00003740| 6f 77 6e 6c 6f 61 64 69 | 6e 67 20 63 61 72 64 2d |ownloadi|ng card-|
|00003750| 64 65 70 65 6e 64 65 6e | 74 20 72 6f 75 74 69 6e |dependen|t routin|
|00003760| 65 73 0d 57 72 69 74 74 | 65 6e 3a 09 38 2f 31 34 |es.Writt|en:.8/14|
|00003770| 2f 39 31 0d 4c 61 73 74 | 20 72 65 76 69 65 77 65 |/91.Last| reviewe|
|00003780| 64 3a 09 38 2f 31 39 2f | 39 32 0d 41 66 74 65 72 |d:.8/19/|92.After|
|00003790| 20 75 70 67 72 61 64 69 | 6e 67 20 74 6f 20 41 2f | upgradi|ng to A/|
|000037a0| 52 4f 53 45 20 31 2e 31 | 2e 32 2c 20 77 68 65 6e |ROSE 1.1|.2, when|
|000037b0| 20 49 20 64 6f 77 6e 6c | 6f 61 64 20 74 6f 20 6d | I downl|oad to m|
|000037c0| 79 20 62 6f 61 72 64 2c | 20 69 74 20 64 6f 65 73 |y board,| it does|
|000037d0| 6e d5 74 20 63 61 6c 6c | 20 6d 79 20 62 6f 61 72 |n.t call| my boar|
|000037e0| 64 2d 73 70 65 63 69 66 | 69 63 20 72 6f 75 74 69 |d-specif|ic routi|
|000037f0| 6e 65 73 20 69 6e 20 74 | 68 65 20 72 65 73 6f 75 |nes in t|he resou|
|00003800| 72 63 65 20 27 68 6c 74 | 61 27 20 74 68 61 74 20 |rce 'hlt|a' that |
|00003810| 49 20 69 6e 73 74 61 6c | 6c 65 64 20 69 6e 74 6f |I instal|led into|
|00003820| 20 41 2f 52 4f 53 45 20 | 50 72 65 70 2e 0d 5f 5f | A/ROSE |Prep..__|
|00003830| 5f 0d 43 68 65 63 6b 20 | 74 68 65 20 67 43 6f 6d |_.Check |the gCom|
|00003840| 6d 6f 6e 20 61 72 65 61 | 20 6f 6e 20 74 68 65 20 |mon area| on the |
|00003850| 63 61 72 64 20 61 74 20 | 6c 6f 63 61 74 69 6f 6e |card at |location|
|00003860| 73 20 67 43 61 72 64 49 | 6e 69 74 30 2c 20 67 43 |s gCardI|nit0, gC|
|00003870| 61 72 64 49 6e 69 74 31 | 2c 20 61 6e 64 20 67 43 |ardInit1|, and gC|
|00003880| 61 72 64 49 6e 69 74 32 | 2e 20 54 68 65 73 65 20 |ardInit2|. These |
|00003890| 61 72 65 20 74 68 65 20 | 61 64 64 72 65 73 73 65 |are the |addresse|
|000038a0| 73 20 77 68 65 72 65 20 | 74 68 65 20 44 6f 77 6e |s where |the Down|
|000038b0| 6c 6f 61 64 20 73 75 62 | 72 6f 75 74 69 6e 65 20 |load sub|routine |
|000038c0| 77 6f 75 6c 64 20 68 61 | 76 65 20 70 6c 61 63 65 |would ha|ve place|
|000038d0| 64 20 74 68 65 20 63 61 | 72 64 2d 64 65 70 65 6e |d the ca|rd-depen|
|000038e0| 64 65 6e 74 20 72 6f 75 | 74 69 6e 65 73 20 77 68 |dent rou|tines wh|
|000038f0| 65 6e 20 70 6c 61 63 69 | 6e 67 20 74 68 65 20 72 |en placi|ng the r|
|00003900| 6f 75 74 69 6e 65 73 20 | 6f 6e 20 74 68 65 20 63 |outines |on the c|
|00003910| 61 72 64 2e 20 59 6f 75 | 20 63 61 6e 20 66 69 6e |ard. You| can fin|
|00003920| 64 20 74 68 65 73 65 20 | 61 64 64 72 65 73 73 65 |d these |addresse|
|00003930| 73 20 69 6e 20 74 68 65 | 20 3a 41 2f 52 4f 53 45 |s in the| :A/ROSE|
|00003940| 3a 69 6e 63 6c 75 64 65 | 73 3a 61 72 6f 73 65 2e |:include|s:arose.|
|00003950| 61 20 68 65 61 64 65 72 | 20 66 69 6c 65 2e 0d 49 |a header| file..I|
|00003960| 66 20 74 68 65 73 65 20 | 61 64 64 72 65 73 73 65 |f these |addresse|
|00003970| 73 20 61 72 65 20 7a 65 | 72 6f 2c 20 74 68 61 74 |s are ze|ro, that|
|00003980| 20 6d 65 61 6e 73 20 65 | 69 74 68 65 72 20 74 68 | means e|ither th|
|00003990| 65 20 44 6f 77 6e 6c 6f | 61 64 20 73 75 62 72 6f |e Downlo|ad subro|
|000039a0| 75 74 69 6e 65 20 66 61 | 69 6c 65 64 20 74 6f 20 |utine fa|iled to |
|000039b0| 66 69 6e 64 20 74 68 65 | 20 63 61 72 64 2d 64 65 |find the| card-de|
|000039c0| 70 65 6e 64 65 6e 74 20 | 72 6f 75 74 69 6e 65 73 |pendent |routines|
|000039d0| 20 77 68 65 6e 20 64 6f | 69 6e 67 20 74 68 65 20 | when do|ing the |
|000039e0| 64 6f 77 6e 6c 6f 61 64 | 69 6e 67 2c 20 6f 72 20 |download|ing, or |
|000039f0| 74 68 65 20 44 6f 77 6e | 6c 6f 61 64 20 73 75 62 |the Down|load sub|
|00003a00| 72 6f 75 74 69 6e 65 20 | 69 73 20 74 68 65 20 77 |routine |is the w|
|00003a10| 72 6f 6e 67 20 76 65 72 | 73 69 6f 6e 20 61 6e 64 |rong ver|sion and|
|00003a20| 20 64 6f 65 73 6e d5 74 | 20 6b 6e 6f 77 20 61 62 | doesn.t| know ab|
|00003a30| 6f 75 74 20 63 61 72 64 | 2d 64 65 70 65 6e 64 65 |out card|-depende|
|00003a40| 6e 74 20 72 6f 75 74 69 | 6e 65 73 2c 20 6f 72 20 |nt routi|nes, or |
|00003a50| 74 68 65 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |the appl|ication |
|00003a60| 64 6f 69 6e 67 20 74 68 | 65 20 64 6f 77 6e 6c 6f |doing th|e downlo|
|00003a70| 61 64 69 6e 67 20 77 61 | 73 20 6e 6f 74 20 6c 69 |ading wa|s not li|
|00003a80| 6e 6b 65 64 20 77 69 74 | 68 20 61 20 72 65 63 65 |nked wit|h a rece|
|00003a90| 6e 74 20 65 6e 6f 75 67 | 68 20 76 65 72 73 69 6f |nt enoug|h versio|
|00003aa0| 6e 20 6f 66 20 44 6f 77 | 6e 6c 6f 61 64 2d 4c 69 |n of Dow|nload-Li|
|00003ab0| 62 2e 6f 20 61 6e 64 20 | 63 6f 6e 74 61 69 6e 73 |b.o and |contains|
|00003ac0| 20 74 68 65 20 6f 6c 64 | 20 44 6f 77 6e 6c 6f 61 | the old| Downloa|
|00003ad0| 64 20 73 75 62 72 6f 75 | 74 69 6e 65 20 63 6f 64 |d subrou|tine cod|
|00003ae0| 65 2e 20 54 68 65 20 61 | 63 74 75 61 6c 20 63 6f |e. The a|ctual co|
|00003af0| 64 65 20 66 6f 72 20 64 | 6f 69 6e 67 20 64 6f 77 |de for d|oing dow|
|00003b00| 6e 6c 6f 61 64 69 6e 67 | 20 68 61 73 20 62 65 65 |nloading| has bee|
|00003b10| 6e 20 6d 6f 76 65 64 20 | 66 72 6f 6d 20 74 68 65 |n moved |from the|
|00003b20| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 74 6f 20 | applica|tion to |
|00003b30| 74 68 65 20 41 2f 52 4f | 53 45 20 50 72 65 70 20 |the A/RO|SE Prep |
|00003b40| 66 69 6c 65 20 61 6e 64 | 20 67 6c 75 65 20 63 6f |file and| glue co|
|00003b50| 64 65 20 69 73 20 6e 6f | 77 20 69 6e 20 74 68 65 |de is no|w in the|
|00003b60| 20 44 6f 77 6e 6c 6f 61 | 64 2d 4c 69 62 2e 6f 20 | Downloa|d-Lib.o |
|00003b70| 66 69 6c 65 2c 20 77 68 | 69 63 68 20 69 73 20 77 |file, wh|ich is w|
|00003b80| 68 61 74 20 74 68 65 20 | 61 70 70 6c 69 63 61 74 |hat the |applicat|
|00003b90| 69 6f 6e 20 72 65 61 6c | 6c 79 20 63 61 6c 6c 73 |ion real|ly calls|
|00003ba0| 2e 20 54 68 69 73 20 67 | 6c 75 65 20 63 6f 64 65 |. This g|lue code|
|00003bb0| 20 6b 6e 6f 77 73 20 68 | 6f 77 20 74 6f 20 6c 6f | knows h|ow to lo|
|00003bc0| 61 64 20 74 68 65 20 61 | 63 74 75 61 6c 20 64 6f |ad the a|ctual do|
|00003bd0| 77 6e 6c 6f 61 64 69 6e | 67 20 63 6f 64 65 2e 0d |wnloadin|g code..|
|00003be0| 49 66 20 74 68 65 73 65 | 20 61 64 64 72 65 73 73 |If these| address|
|00003bf0| 65 73 20 61 72 65 20 6e | 6f 6e 7a 65 72 6f 2c 20 |es are n|onzero, |
|00003c00| 41 2f 52 4f 53 45 2c 20 | 64 75 72 69 6e 67 20 69 |A/ROSE, |during i|
|00003c10| 74 73 20 69 6e 69 74 69 | 61 6c 69 7a 61 74 69 6f |ts initi|alizatio|
|00003c20| 6e 2c 20 73 68 6f 75 6c | 64 20 63 61 6c 6c 20 74 |n, shoul|d call t|
|00003c30| 68 65 73 65 20 72 6f 75 | 74 69 6e 65 73 2e 20 49 |hese rou|tines. I|
|00003c40| 66 20 41 2f 52 4f 53 45 | 20 69 73 20 6e 6f 74 20 |f A/ROSE| is not |
|00003c50| 63 61 6c 6c 69 6e 67 20 | 74 68 65 6d 2c 20 63 68 |calling |them, ch|
|00003c60| 65 63 6b 20 74 6f 20 73 | 65 65 20 77 68 65 72 65 |eck to s|ee where|
|00003c70| 20 74 68 65 20 41 2f 52 | 4f 53 45 20 6b 65 72 6e | the A/R|OSE kern|
|00003c80| 65 6c 20 69 73 20 63 6f | 6d 69 6e 67 20 66 72 6f |el is co|ming fro|
|00003c90| 6d 2e 20 57 61 73 20 74 | 68 65 20 41 2f 52 4f 53 |m. Was t|he A/ROS|
|00003ca0| 45 20 6b 65 72 6e 65 6c | 20 6c 69 6e 6b 65 64 20 |E kernel| linked |
|00003cb0| 69 6e 20 77 69 74 68 20 | 74 68 65 20 63 6f 64 65 |in with |the code|
|00003cc0| 3f 20 49 6e 20 74 68 69 | 73 20 63 61 73 65 2c 20 |? In thi|s case, |
|00003cd0| 79 6f 75 20 6e 65 65 64 | 20 74 6f 20 72 65 6c 69 |you need| to reli|
|00003ce0| 6e 6b 20 79 6f 75 72 20 | 63 6f 64 65 20 77 69 74 |nk your |code wit|
|00003cf0| 68 20 61 20 6d 6f 72 65 | 20 72 65 63 65 6e 74 20 |h a more| recent |
|00003d00| 76 65 72 73 69 6f 6e 20 | 6f 66 20 74 68 65 20 41 |version |of the A|
|00003d10| 2f 52 4f 53 45 20 6b 65 | 72 6e 65 6c 2e 0d 41 2f |/ROSE ke|rnel..A/|
|00003d20| 52 4f 53 45 20 4e 65 74 | 43 6f 70 79 20 70 72 6f |ROSE Net|Copy pro|
|00003d30| 63 65 73 73 20 64 65 73 | 63 72 69 70 74 69 6f 6e |cess des|cription|
|00003d40| 0d 57 72 69 74 74 65 6e | 3a 09 38 2f 33 30 2f 39 |.Written|:.8/30/9|
|00003d50| 31 0d 4c 61 73 74 20 72 | 65 76 69 65 77 65 64 3a |1.Last r|eviewed:|
|00003d60| 09 38 2f 31 39 2f 39 32 | 0d 48 6f 77 20 64 6f 65 |.8/19/92|.How doe|
|00003d70| 73 20 74 68 65 20 4e 65 | 74 43 6f 70 79 20 63 56 |s the Ne|tCopy cV|
|00003d80| 69 72 74 75 61 6c 54 6f | 52 65 61 6c 20 72 6f 75 |irtualTo|Real rou|
|00003d90| 74 69 6e 65 20 77 6f 72 | 6b 20 69 6e 20 74 68 65 |tine wor|k in the|
|00003da0| 20 6f 73 63 67 6c 75 65 | 2e 61 20 66 69 6c 65 20 | oscglue|.a file |
|00003db0| 6f 66 20 74 68 65 20 50 | 6f 72 74 61 62 6c 65 20 |of the P|ortable |
|00003dc0| 41 2f 52 4f 53 45 20 63 | 6f 64 65 3f 20 49 d5 6d |A/ROSE c|ode? I.m|
|00003dd0| 20 74 72 79 69 6e 67 20 | 74 6f 20 65 6d 75 6c 61 | trying |to emula|
|00003de0| 74 65 20 74 68 65 20 4e | 65 74 43 6f 70 79 20 63 |te the N|etCopy c|
|00003df0| 6f 6d 6d 61 6e 64 20 69 | 6e 20 6d 79 20 41 2f 52 |ommand i|n my A/R|
|00003e00| 4f 53 45 20 63 6f 64 65 | 2e 20 49 20 77 61 6e 74 |OSE code|. I want|
|00003e10| 20 74 68 65 20 63 6f 70 | 79 20 72 6f 75 74 69 6e | the cop|y routin|
|00003e20| 65 20 74 6f 20 77 6f 72 | 6b 20 77 69 74 68 6f 75 |e to wor|k withou|
|00003e30| 74 20 72 65 71 75 69 72 | 69 6e 67 20 74 68 65 20 |t requir|ing the |
|00003e40| 75 73 65 72 20 74 6f 20 | 75 73 65 20 74 68 65 20 |user to |use the |
|00003e50| 4c 6f 63 6b 52 65 61 6c | 41 72 65 61 20 63 6f 6d |LockReal|Area com|
|00003e60| 6d 61 6e 64 20 6f 6e 20 | 74 68 65 20 4d 61 63 69 |mand on |the Maci|
|00003e70| 6e 74 6f 73 68 20 4f 70 | 65 72 61 74 69 6e 67 20 |ntosh Op|erating |
|00003e80| 53 79 73 74 65 6d 20 73 | 69 64 65 2c 20 62 75 74 |System s|ide, but|
|00003e90| 20 74 68 69 73 20 6d 65 | 61 6e 73 20 74 68 61 74 | this me|ans that|
|00003ea0| 20 49 20 68 61 76 65 20 | 74 6f 20 77 6f 72 72 79 | I have |to worry|
|00003eb0| 20 61 62 6f 75 74 20 74 | 68 65 20 61 64 64 72 65 | about t|he addre|
|00003ec0| 73 73 69 6e 67 20 62 65 | 69 6e 67 20 70 61 73 73 |ssing be|ing pass|
|00003ed0| 65 64 20 69 6e 20 61 73 | 20 62 65 69 6e 67 20 76 |ed in as| being v|
|00003ee0| 69 72 74 75 61 6c 2e 20 | 49 73 20 74 68 65 20 41 |irtual. |Is the A|
|00003ef0| 2f 52 4f 53 45 20 6b 65 | 72 6e 65 6c 20 6f 6e 20 |/ROSE ke|rnel on |
|00003f00| 74 68 65 20 62 6f 61 72 | 64 20 70 72 6f 76 69 64 |the boar|d provid|
|00003f10| 69 6e 67 20 74 68 65 20 | 76 69 72 74 75 61 6c 2d |ing the |virtual-|
|00003f20| 74 6f 2d 72 65 61 6c 20 | 6d 61 70 70 69 6e 67 20 |to-real |mapping |
|00003f30| 6f 72 20 64 6f 65 73 20 | 69 74 20 6a 75 73 74 20 |or does |it just |
|00003f40| 73 65 6e 64 20 61 20 6d | 65 73 73 61 67 65 20 62 |send a m|essage b|
|00003f50| 61 63 6b 20 74 6f 20 41 | 2f 52 4f 53 45 20 50 72 |ack to A|/ROSE Pr|
|00003f60| 65 70 20 74 6f 20 64 6f | 20 69 74 20 61 6e 64 20 |ep to do| it and |
|00003f70| 74 68 65 6e 20 75 73 65 | 20 74 68 65 20 72 65 73 |then use| the res|
|00003f80| 75 6c 74 73 3f 0d 5f 5f | 5f 0d 57 68 61 74 20 63 |ults?.__|_.What c|
|00003f90| 56 69 72 74 75 61 6c 54 | 6f 52 65 61 6c 28 29 20 |VirtualT|oReal() |
|00003fa0| 64 6f 65 73 20 69 73 20 | 74 61 6b 65 20 61 73 20 |does is |take as |
|00003fb0| 69 6e 70 75 74 2c 20 61 | 20 74 72 61 6e 73 61 63 |input, a| transac|
|00003fc0| 74 69 6f 6e 20 49 44 20 | 28 54 49 44 29 2c 20 61 |tion ID |(TID), a|
|00003fd0| 20 76 69 72 74 75 61 6c | 20 61 64 64 72 65 73 73 | virtual| address|
|00003fe0| 20 61 6e 64 20 61 20 73 | 69 7a 65 2e 20 49 74 20 | and a s|ize. It |
|00003ff0| 72 65 74 75 72 6e 73 20 | 61 20 4e 75 42 75 73 20 |returns |a NuBus |
|00004000| 61 64 64 72 65 73 73 20 | 61 6e 64 20 61 20 73 69 |address |and a si|
|00004010| 7a 65 2e 20 49 66 20 74 | 68 65 20 72 65 74 75 72 |ze. If t|he retur|
|00004020| 6e 65 64 20 73 69 7a 65 | 20 69 73 20 7a 65 72 6f |ned size| is zero|
|00004030| 2c 20 63 56 69 72 74 75 | 61 6c 54 6f 52 65 61 6c |, cVirtu|alToReal|
|00004040| 28 29 20 63 6f 75 6c 64 | 20 6e 6f 74 20 66 69 6e |() could| not fin|
|00004050| 64 20 61 20 63 6f 72 72 | 65 73 70 6f 6e 64 69 6e |d a corr|espondin|
|00004060| 67 20 4e 75 42 75 73 20 | 61 64 64 72 65 73 73 20 |g NuBus |address |
|00004070| 66 6f 72 20 74 68 65 20 | 76 69 72 74 75 61 6c 20 |for the |virtual |
|00004080| 61 64 64 72 65 73 73 2e | 20 49 66 20 74 68 65 20 |address.| If the |
|00004090| 72 65 74 75 72 6e 65 64 | 20 73 69 7a 65 20 69 73 |returned| size is|
|000040a0| 20 6e 6f 6e 2d 7a 65 72 | 6f 2c 20 74 68 69 73 20 | non-zer|o, this |
|000040b0| 73 69 7a 65 20 69 73 20 | 74 68 65 20 73 69 7a 65 |size is |the size|
|000040c0| 20 6f 66 20 74 68 65 20 | 63 6f 6e 74 69 67 75 6f | of the |contiguo|
|000040d0| 75 73 20 61 64 64 72 65 | 73 73 20 72 61 6e 67 65 |us addre|ss range|
|000040e0| 20 66 6f 72 20 74 68 65 | 20 76 69 72 74 75 61 6c | for the| virtual|
|000040f0| 20 61 64 64 72 65 73 73 | 20 73 74 61 72 74 69 6e | address| startin|
|00004100| 67 20 61 74 20 74 68 65 | 20 4e 75 42 75 73 20 61 |g at the| NuBus a|
|00004110| 64 64 72 65 73 73 2e 0d | 54 68 69 73 20 69 73 20 |ddress..|This is |
|00004120| 68 6f 77 20 63 56 69 72 | 74 75 61 6c 54 6f 52 65 |how cVir|tualToRe|
|00004130| 61 6c 28 29 20 77 6f 72 | 6b 73 3a 20 63 56 69 72 |al() wor|ks: cVir|
|00004140| 74 75 61 6c 54 6f 52 65 | 61 6c 28 29 20 65 78 61 |tualToRe|al() exa|
|00004150| 6d 69 6e 65 73 20 74 68 | 65 20 54 49 44 20 74 6f |mines th|e TID to|
|00004160| 20 66 69 6e 64 20 6f 75 | 74 20 74 68 65 20 73 6c | find ou|t the sl|
|00004170| 6f 74 20 28 63 61 6c 6c | 20 69 74 20 73 6c 6f 74 |ot (call| it slot|
|00004180| 20 73 29 20 61 73 73 6f | 63 69 61 74 65 64 20 77 | s) asso|ciated w|
|00004190| 69 74 68 20 74 68 65 20 | 54 49 44 2e 20 63 56 69 |ith the |TID. cVi|
|000041a0| 72 74 75 61 6c 54 6f 52 | 65 61 6c 28 29 20 6c 6f |rtualToR|eal() lo|
|000041b0| 6f 6b 73 20 61 74 20 74 | 68 65 20 69 63 63 6d 20 |oks at t|he iccm |
|000041c0| 63 6f 6d 6d 75 6e 69 63 | 61 74 69 6f 6e 73 20 61 |communic|ations a|
|000041d0| 72 65 61 20 6f 66 20 73 | 6c 6f 74 20 73 20 6c 6f |rea of s|lot s lo|
|000041e0| 6f 6b 69 6e 67 20 61 74 | 20 4d 61 70 43 6e 74 2c |oking at| MapCnt,|
|000041f0| 20 4d 61 70 50 74 72 2c | 20 61 6e 64 20 4d 61 70 | MapPtr,| and Map|
|00004200| 43 68 6b 2e 20 28 50 6c | 65 61 73 65 20 72 65 66 |Chk. (Pl|ease ref|
|00004210| 65 72 20 74 6f 20 69 63 | 63 6d 44 65 66 73 2e 68 |er to ic|cmDefs.h|
|00004220| 20 6f 72 20 69 63 63 6d | 44 65 66 73 2e 61 20 69 | or iccm|Defs.a i|
|00004230| 6e 20 74 68 65 20 69 63 | 63 6d 20 63 6f 6d 6d 75 |n the ic|cm commu|
|00004240| 6e 69 63 61 74 69 6f 6e | 73 20 61 72 65 61 20 72 |nication|s area r|
|00004250| 65 63 6f 72 64 20 63 61 | 5f 52 65 63 2e 29 0d 49 |ecord ca|_Rec.).I|
|00004260| 66 20 4d 61 70 43 6e 74 | 20 69 73 20 7a 65 72 6f |f MapCnt| is zero|
|00004270| 2c 20 74 68 65 20 76 69 | 72 74 75 61 6c 20 61 64 |, the vi|rtual ad|
|00004280| 64 72 65 73 73 20 69 73 | 20 61 73 73 75 6d 65 64 |dress is| assumed|
|00004290| 20 74 6f 20 62 65 20 74 | 68 65 20 73 61 6d 65 20 | to be t|he same |
|000042a0| 61 73 20 74 68 65 20 4e | 75 42 75 73 20 61 64 64 |as the N|uBus add|
|000042b0| 72 65 73 73 2e 20 49 6e | 20 74 68 69 73 20 63 61 |ress. In| this ca|
|000042c0| 73 65 2c 20 63 56 69 72 | 74 75 61 6c 54 6f 52 65 |se, cVir|tualToRe|
|000042d0| 61 6c 28 29 20 73 65 74 | 73 20 74 68 65 20 72 65 |al() set|s the re|
|000042e0| 74 75 72 6e 65 64 20 4e | 75 42 75 73 20 61 64 64 |turned N|uBus add|
|000042f0| 72 65 73 73 20 76 61 6c | 75 65 20 74 6f 20 62 65 |ress val|ue to be|
|00004300| 20 74 68 61 74 20 6f 66 | 20 74 68 65 20 76 69 72 | that of| the vir|
|00004310| 74 75 61 6c 20 61 64 64 | 72 65 73 73 20 61 6e 64 |tual add|ress and|
|00004320| 20 72 65 74 75 72 6e 73 | 20 74 68 65 20 73 69 7a | returns| the siz|
|00004330| 65 20 74 68 65 20 73 61 | 6d 65 20 61 73 20 74 68 |e the sa|me as th|
|00004340| 65 20 73 69 7a 65 20 6f | 6e 20 69 6e 70 75 74 2e |e size o|n input.|
|00004350| 0d 49 66 20 4d 61 70 43 | 6e 74 20 69 73 20 6e 6f |.If MapC|nt is no|
|00004360| 6e 7a 65 72 6f 2c 20 74 | 68 65 20 73 6c 6f 74 20 |nzero, t|he slot |
|00004370| 65 69 74 68 65 72 20 68 | 61 73 20 61 6e 20 61 64 |either h|as an ad|
|00004380| 64 72 65 73 73 20 73 63 | 68 65 6d 65 20 77 68 65 |dress sc|heme whe|
|00004390| 72 65 20 74 68 65 20 76 | 69 72 74 75 61 6c 20 61 |re the v|irtual a|
|000043a0| 64 64 72 65 73 73 20 74 | 68 61 74 20 74 68 65 20 |ddress t|hat the |
|000043b0| 54 49 44 20 6f 6e 20 73 | 6c 6f 74 20 73 20 75 73 |TID on s|lot s us|
|000043c0| 65 73 20 63 61 6e 6e 6f | 74 20 62 65 20 74 68 65 |es canno|t be the|
|000043d0| 20 73 61 6d 65 20 61 73 | 20 74 68 65 20 4e 75 42 | same as| the NuB|
|000043e0| 75 73 20 61 64 64 72 65 | 73 73 20 28 73 61 79 20 |us addre|ss (say |
|000043f0| 74 68 65 20 70 72 6f 63 | 65 73 73 6f 72 20 77 61 |the proc|essor wa|
|00004400| 73 20 61 20 36 38 30 32 | 30 20 77 69 74 68 20 6e |s a 6802|0 with n|
|00004410| 6f 20 50 4d 4d 55 20 61 | 6e 64 20 72 65 71 75 69 |o PMMU a|nd requi|
|00004420| 72 65 64 20 74 68 61 74 | 20 6c 6f 63 61 6c 20 63 |red that| local c|
|00004430| 61 72 64 20 61 64 64 72 | 65 73 73 65 73 20 68 61 |ard addr|esses ha|
|00004440| 76 65 20 7a 65 72 6f 20 | 66 6f 72 20 74 68 65 20 |ve zero |for the |
|00004450| 68 69 67 68 20 61 64 64 | 72 65 73 73 20 62 79 74 |high add|ress byt|
|00004460| 65 29 20 6f 72 20 74 68 | 65 20 73 6c 6f 74 20 68 |e) or th|e slot h|
|00004470| 61 73 20 73 6f 6d 65 74 | 68 69 6e 67 20 6c 69 6b |as somet|hing lik|
|00004480| 65 20 56 4d 20 28 77 68 | 69 63 68 20 69 73 20 77 |e VM (wh|ich is w|
|00004490| 68 61 74 20 68 61 70 70 | 65 6e 73 20 6f 6e 20 74 |hat happ|ens on t|
|000044a0| 68 65 20 6d 61 69 6e 20 | 6c 6f 67 69 63 20 62 6f |he main |logic bo|
|000044b0| 61 72 64 29 2e 20 63 56 | 69 72 74 75 61 6c 54 6f |ard). cV|irtualTo|
|000044c0| 52 65 61 6c 28 29 20 77 | 69 6c 6c 20 75 73 65 20 |Real() w|ill use |
|000044d0| 74 68 65 20 61 64 64 72 | 65 73 73 20 6d 61 70 20 |the addr|ess map |
|000044e0| 70 6f 69 6e 74 65 64 20 | 74 6f 20 62 79 20 4d 61 |pointed |to by Ma|
|000044f0| 70 50 74 72 20 6f 6e 20 | 73 6c 6f 74 20 73 20 74 |pPtr on |slot s t|
|00004500| 6f 20 74 72 79 20 74 6f | 20 72 65 73 6f 6c 76 65 |o try to| resolve|
|00004510| 20 74 68 65 20 76 69 72 | 74 75 61 6c 20 61 64 64 | the vir|tual add|
|00004520| 72 65 73 73 20 74 6f 20 | 61 20 4e 75 42 75 73 20 |ress to |a NuBus |
|00004530| 61 64 64 72 65 73 73 2e | 20 4d 61 70 50 74 72 20 |address.| MapPtr |
|00004540| 69 73 20 61 20 70 6f 69 | 6e 74 65 72 20 74 6f 20 |is a poi|nter to |
|00004550| 61 20 6c 69 6e 6b 65 64 | 20 6c 69 73 74 20 6f 66 |a linked| list of|
|00004560| 20 73 74 72 75 63 74 20 | 41 64 64 72 4d 61 70 20 | struct |AddrMap |
|00004570| 28 64 65 66 69 6e 65 64 | 20 69 6e 20 6f 73 2e 68 |(defined| in os.h|
|00004580| 20 6f 72 20 6f 73 2e 61 | 29 2e 20 49 66 20 63 56 | or os.a|). If cV|
|00004590| 69 72 74 75 61 6c 54 6f | 52 65 61 6c 28 29 20 63 |irtualTo|Real() c|
|000045a0| 61 6e 20 72 65 73 6f 6c | 76 65 20 74 68 65 20 76 |an resol|ve the v|
|000045b0| 69 72 74 75 61 6c 20 61 | 64 64 72 65 73 73 20 62 |irtual a|ddress b|
|000045c0| 79 20 6c 6f 6f 6b 69 6e | 67 20 61 74 20 74 68 65 |y lookin|g at the|
|000045d0| 20 41 64 64 72 4d 61 70 | 20 65 6e 74 72 69 65 73 | AddrMap| entries|
|000045e0| 2c 20 69 74 20 77 69 6c | 6c 20 64 6f 20 73 6f 2e |, it wil|l do so.|
|000045f0| 20 49 66 20 63 56 69 72 | 74 75 61 6c 54 6f 52 65 | If cVir|tualToRe|
|00004600| 61 6c 28 29 20 63 61 6e | 6e 6f 74 2c 20 69 74 20 |al() can|not, it |
|00004610| 77 69 6c 6c 20 72 65 74 | 75 72 6e 20 7a 65 72 6f |will ret|urn zero|
|00004620| 20 66 6f 72 20 74 68 65 | 20 73 69 7a 65 2e 20 54 | for the| size. T|
|00004630| 68 65 20 4d 61 70 43 68 | 6b 20 61 6e 64 20 4d 61 |he MapCh|k and Ma|
|00004640| 70 43 6e 74 20 76 61 72 | 69 61 62 6c 65 73 20 69 |pCnt var|iables i|
|00004650| 6e 20 63 61 5f 52 65 63 | 20 61 72 65 20 75 73 65 |n ca_Rec| are use|
|00004660| 64 20 66 6f 72 20 63 6f | 6e 63 75 72 72 65 6e 63 |d for co|ncurrenc|
|00004670| 79 2e 20 63 56 69 72 74 | 75 61 6c 54 6f 52 65 61 |y. cVirt|ualToRea|
|00004680| 6c 28 29 20 77 69 6c 6c | 20 66 65 74 63 68 20 61 |l() will| fetch a|
|00004690| 20 70 6f 69 6e 74 65 72 | 20 66 72 6f 6d 20 74 68 | pointer| from th|
|000046a0| 65 20 4d 61 70 50 74 72 | 20 73 74 72 75 63 74 75 |e MapPtr| structu|
|000046b0| 72 65 20 61 6e 64 20 74 | 68 65 6e 20 63 68 65 63 |re and t|hen chec|
|000046c0| 6b 20 74 6f 20 73 65 65 | 20 69 66 20 4d 61 70 43 |k to see| if MapC|
|000046d0| 68 6b 20 68 61 73 20 63 | 68 61 6e 67 65 64 2e 20 |hk has c|hanged. |
|000046e0| 63 56 69 72 74 75 61 6c | 54 6f 52 65 61 6c 28 29 |cVirtual|ToReal()|
|000046f0| 20 6b 6e 6f 77 73 20 74 | 68 61 74 20 74 68 65 20 | knows t|hat the |
|00004700| 70 6f 69 6e 74 65 72 73 | 20 69 6e 20 4d 61 70 50 |pointers| in MapP|
|00004710| 74 72 20 61 6e 64 20 74 | 68 65 20 41 64 64 72 4d |tr and t|he AddrM|
|00004720| 61 70 20 65 6e 74 72 79 | 20 68 61 76 65 20 6e 6f |ap entry| have no|
|00004730| 74 20 63 68 61 6e 67 65 | 64 20 69 66 20 4d 61 70 |t change|d if Map|
|00004740| 43 68 6b 20 68 61 73 20 | 6e 6f 74 20 63 68 61 6e |Chk has |not chan|
|00004750| 67 65 64 2e 20 63 56 69 | 72 74 75 61 6c 54 6f 52 |ged. cVi|rtualToR|
|00004760| 65 61 6c 28 29 20 73 74 | 61 72 74 73 20 69 74 73 |eal() st|arts its|
|00004770| 20 73 65 61 72 63 68 20 | 6f 76 65 72 20 61 74 20 | search |over at |
|00004780| 74 68 65 20 62 65 67 69 | 6e 6e 69 6e 67 20 6f 66 |the begi|nning of|
|00004790| 20 74 68 65 20 4d 61 70 | 50 74 72 20 6c 69 73 74 | the Map|Ptr list|
|000047a0| 20 73 68 6f 75 6c 64 20 | 4d 61 70 43 68 6b 20 63 | should |MapChk c|
|000047b0| 68 61 6e 67 65 2e 20 63 | 56 69 72 74 75 61 6c 54 |hange. c|VirtualT|
|000047c0| 6f 52 65 61 6c 28 29 20 | 6b 6e 6f 77 73 20 74 68 |oReal() |knows th|
|000047d0| 61 74 20 69 74 20 63 61 | 6e 20 73 74 61 72 74 20 |at it ca|n start |
|000047e0| 73 65 61 72 63 68 69 6e | 67 20 74 68 65 20 4d 61 |searchin|g the Ma|
|000047f0| 70 50 74 72 20 6c 69 73 | 74 20 6f 6e 6c 79 20 77 |pPtr lis|t only w|
|00004800| 68 65 6e 20 4d 61 70 43 | 6e 74 20 65 71 75 61 6c |hen MapC|nt equal|
|00004810| 73 20 4d 61 70 43 68 6b | 2e 0d 57 68 61 74 20 63 |s MapChk|..What c|
|00004820| 4c 6f 63 6b 52 65 61 6c | 41 72 65 61 28 29 20 64 |LockReal|Area() d|
|00004830| 6f 65 73 20 69 73 20 74 | 61 6b 65 20 61 73 20 69 |oes is t|ake as i|
|00004840| 6e 70 75 74 20 61 20 76 | 69 72 74 75 61 6c 20 61 |nput a v|irtual a|
|00004850| 64 64 72 65 73 73 20 61 | 6e 64 20 73 69 7a 65 20 |ddress a|nd size |
|00004860| 61 6e 64 20 72 65 74 75 | 72 6e 73 20 6f 6e 20 6f |and retu|rns on o|
|00004870| 75 74 70 75 74 20 74 68 | 65 20 4e 75 42 75 73 20 |utput th|e NuBus |
|00004880| 61 64 64 72 65 73 73 2f | 6c 65 6e 67 74 68 20 70 |address/|length p|
|00004890| 61 69 72 73 20 61 73 73 | 6f 63 69 61 74 65 64 20 |airs ass|ociated |
|000048a0| 77 69 74 68 20 74 68 61 | 74 20 76 69 72 74 75 61 |with tha|t virtua|
|000048b0| 6c 20 61 64 64 72 65 73 | 73 20 61 6e 64 20 73 69 |l addres|s and si|
|000048c0| 7a 65 2e 20 63 4c 6f 63 | 6b 52 65 61 6c 41 72 65 |ze. cLoc|kRealAre|
|000048d0| 61 28 29 20 61 6c 73 6f | 20 72 65 74 75 72 6e 73 |a() also| returns|
|000048e0| 20 61 20 73 75 63 63 65 | 73 73 2f 66 61 69 6c 75 | a succe|ss/failu|
|000048f0| 72 65 20 73 74 61 74 75 | 73 20 69 6e 64 69 63 61 |re statu|s indica|
|00004900| 74 69 6e 67 20 69 66 20 | 63 4c 6f 63 6b 52 65 61 |ting if |cLockRea|
|00004910| 6c 41 72 65 61 28 29 20 | 73 75 63 63 65 73 73 66 |lArea() |successf|
|00004920| 75 6c 6c 79 20 d2 6c 6f | 63 6b 65 64 d3 20 74 68 |ully .lo|cked. th|
|00004930| 65 20 70 61 67 65 73 20 | 69 6e 20 6d 65 6d 6f 72 |e pages |in memor|
|00004940| 79 20 61 73 73 6f 63 69 | 61 74 65 64 20 77 69 74 |y associ|ated wit|
|00004950| 68 20 74 68 65 20 76 69 | 72 74 75 61 6c 20 61 64 |h the vi|rtual ad|
|00004960| 64 72 65 73 73 20 61 6e | 64 20 73 69 7a 65 2e 0d |dress an|d size..|
|00004970| 50 6c 65 61 73 65 20 6e | 6f 74 65 3a 20 54 68 65 |Please n|ote: The|
|00004980| 72 65 20 69 73 20 61 20 | 63 4c 6f 63 6b 52 65 61 |re is a |cLockRea|
|00004990| 6c 41 72 65 61 28 29 20 | 6f 6e 20 74 68 65 20 6d |lArea() |on the m|
|000049a0| 61 69 6e 20 6c 6f 67 69 | 63 20 62 6f 61 72 64 20 |ain logi|c board |
|000049b0| 75 73 65 64 20 74 6f 20 | 6c 6f 63 6b 20 6d 65 6d |used to |lock mem|
|000049c0| 6f 72 79 20 6f 6e 20 74 | 68 65 20 6d 61 69 6e 20 |ory on t|he main |
|000049d0| 6c 6f 67 69 63 20 62 6f | 61 72 64 2e 20 54 68 65 |logic bo|ard. The|
|000049e0| 72 65 20 69 73 20 61 6c | 73 6f 20 61 20 63 4c 6f |re is al|so a cLo|
|000049f0| 63 6b 52 65 61 6c 41 72 | 65 61 28 29 20 69 6e 20 |ckRealAr|ea() in |
|00004a00| 74 68 65 20 41 2f 52 4f | 53 45 20 6b 65 72 6e 65 |the A/RO|SE kerne|
|00004a10| 6c 20 6f 6e 20 74 68 65 | 20 4e 75 42 75 73 20 63 |l on the| NuBus c|
|00004a20| 61 72 64 20 77 68 69 63 | 68 20 57 4f 55 4c 44 20 |ard whic|h WOULD |
|00004a30| 6c 6f 63 6b 20 6d 65 6d | 6f 72 79 20 6f 6e 20 74 |lock mem|ory on t|
|00004a40| 68 65 20 4e 75 42 75 73 | 20 63 61 72 64 2e 20 54 |he NuBus| card. T|
|00004a50| 68 65 20 63 4c 6f 63 6b | 52 65 61 6c 41 72 65 61 |he cLock|RealArea|
|00004a60| 28 29 20 6f 6e 20 74 68 | 65 20 4e 75 42 75 73 20 |() on th|e NuBus |
|00004a70| 63 61 72 64 20 61 63 74 | 73 20 61 73 20 61 20 6e |card act|s as a n|
|00004a80| 6f 2d 6f 70 20 61 74 20 | 74 68 69 73 20 6d 6f 6d |o-op at |this mom|
|00004a90| 65 6e 74 20 61 6e 64 20 | 69 73 20 70 72 65 73 65 |ent and |is prese|
|00004aa0| 6e 74 20 66 6f 72 20 63 | 6f 6d 70 61 74 69 62 69 |nt for c|ompatibi|
|00004ab0| 6c 69 74 79 20 72 65 61 | 73 6f 6e 73 2e 0d 48 65 |lity rea|sons..He|
|00004ac0| 72 65 d5 73 20 61 20 64 | 65 73 63 72 69 70 74 69 |re.s a d|escripti|
|00004ad0| 6f 6e 20 6f 66 20 68 6f | 77 20 63 4c 6f 63 6b 52 |on of ho|w cLockR|
|00004ae0| 65 61 6c 41 72 65 61 28 | 29 20 77 6f 72 6b 73 3a |ealArea(|) works:|
|00004af0| 20 63 4c 6f 63 6b 52 65 | 61 6c 41 72 65 61 28 29 | cLockRe|alArea()|
|00004b00| 20 6f 6e 20 61 20 4e 75 | 42 75 73 20 63 61 72 64 | on a Nu|Bus card|
|00004b10| 20 61 63 74 73 20 61 73 | 20 61 20 6e 6f 2d 6f 70 | acts as| a no-op|
|00004b20| 2e 20 63 4c 6f 63 6b 52 | 65 61 6c 41 72 65 61 28 |. cLockR|ealArea(|
|00004b30| 29 20 6f 6e 20 61 20 4e | 75 42 75 73 20 63 61 72 |) on a N|uBus car|
|00004b40| 64 20 72 65 74 75 72 6e | 73 20 61 20 4e 75 42 75 |d return|s a NuBu|
|00004b50| 73 20 61 64 64 72 65 73 | 73 2f 6c 65 6e 67 74 68 |s addres|s/length|
|00004b60| 20 70 61 69 72 20 61 73 | 20 6f 6e 65 20 77 6f 75 | pair as| one wou|
|00004b70| 6c 64 20 65 78 70 65 63 | 74 20 62 75 74 20 6f 74 |ld expec|t but ot|
|00004b80| 68 65 72 77 69 73 65 20 | 64 6f 65 73 20 6e 6f 74 |herwise |does not|
|00004b90| 68 69 6e 67 2e 0d 63 4c | 6f 63 6b 52 65 61 6c 41 |hing..cL|ockRealA|
|00004ba0| 72 65 61 28 29 20 6f 6e | 20 74 68 65 20 6d 61 69 |rea() on| the mai|
|00004bb0| 6e 20 6c 6f 67 69 63 20 | 62 6f 61 72 64 20 69 73 |n logic |board is|
|00004bc0| 20 6d 75 63 68 20 6d 6f | 72 65 20 69 6e 74 65 72 | much mo|re inter|
|00004bd0| 65 73 74 69 6e 67 2e 20 | 63 4c 6f 63 6b 52 65 61 |esting. |cLockRea|
|00004be0| 6c 41 72 65 61 28 29 20 | 6f 6e 20 74 68 65 20 6d |lArea() |on the m|
|00004bf0| 61 69 6e 20 6c 6f 67 69 | 63 20 62 6f 61 72 64 20 |ain logi|c board |
|00004c00| 74 72 69 65 73 20 74 6f | 20 6c 6f 63 6b 20 64 6f |tries to| lock do|
|00004c10| 77 6e 20 74 68 65 20 70 | 61 67 65 73 20 61 73 73 |wn the p|ages ass|
|00004c20| 6f 63 69 61 74 65 64 20 | 77 69 74 68 20 74 68 65 |ociated |with the|
|00004c30| 20 76 69 72 74 75 61 6c | 20 61 64 64 72 65 73 73 | virtual| address|
|00004c40| 2f 73 69 7a 65 20 28 61 | 73 73 75 6d 69 6e 67 20 |/size (a|ssuming |
|00004c50| 61 20 50 4d 4d 55 20 69 | 73 20 70 72 65 73 65 6e |a PMMU i|s presen|
|00004c60| 74 20 61 6e 64 20 74 68 | 65 20 61 70 70 72 6f 70 |t and th|e approp|
|00004c70| 72 69 61 74 65 20 61 5f | 6c 69 6e 65 20 74 72 61 |riate a_|line tra|
|00004c80| 70 73 20 61 72 65 20 70 | 72 65 73 65 6e 74 29 20 |ps are p|resent) |
|00004c90| 63 61 6c 6c 69 6e 67 20 | 65 69 74 68 65 72 20 5f |calling |either _|
|00004ca0| 4c 6f 63 6b 4d 65 6d 6f | 72 79 20 6f 72 20 5f 4c |LockMemo|ry or _L|
|00004cb0| 6f 63 6b 4d 65 6d 6f 72 | 79 43 6f 6e 74 69 67 75 |ockMemor|yContigu|
|00004cc0| 6f 75 73 2e 20 4e 65 78 | 74 2c 20 69 66 20 5f 4c |ous. Nex|t, if _L|
|00004cd0| 6f 63 6b 4d 65 6d 6f 72 | 79 20 6f 72 20 5f 4c 6f |ockMemor|y or _Lo|
|00004ce0| 63 6b 4d 65 6d 6f 72 79 | 43 6f 6e 74 69 67 75 6f |ckMemory|Contiguo|
|00004cf0| 75 73 20 77 6f 72 6b 73 | 2c 20 63 4c 6f 63 6b 52 |us works|, cLockR|
|00004d00| 65 61 6c 41 72 65 61 28 | 29 20 74 72 69 65 73 20 |ealArea(|) tries |
|00004d10| 74 6f 20 63 72 65 61 74 | 65 20 61 6e 20 41 64 64 |to creat|e an Add|
|00004d20| 72 4d 61 70 20 65 6e 74 | 72 79 20 74 6f 20 73 74 |rMap ent|ry to st|
|00004d30| 6f 72 65 20 74 68 65 20 | 4e 75 42 75 73 20 61 64 |ore the |NuBus ad|
|00004d40| 64 72 65 73 73 65 73 20 | 61 73 73 6f 63 69 61 74 |dresses |associat|
|00004d50| 65 64 20 77 69 74 68 20 | 74 68 65 20 76 69 72 74 |ed with |the virt|
|00004d60| 75 61 6c 20 61 64 64 72 | 65 73 73 2e 20 63 4c 6f |ual addr|ess. cLo|
|00004d70| 63 6b 52 65 61 6c 41 72 | 65 61 28 29 20 6e 65 65 |ckRealAr|ea() nee|
|00004d80| 64 73 20 74 6f 20 63 61 | 6c 6c 20 5f 4c 6f 63 6b |ds to ca|ll _Lock|
|00004d90| 4d 65 6d 6f 72 79 43 6f | 6e 74 69 67 75 6f 75 73 |MemoryCo|ntiguous|
|00004da0| 20 6f 6e 20 74 68 69 73 | 20 41 64 64 72 4d 61 70 | on this| AddrMap|
|00004db0| 20 65 6e 74 72 79 20 74 | 6f 20 6c 6f 63 6b 20 69 | entry t|o lock i|
|00004dc0| 74 20 64 6f 77 6e 20 61 | 73 20 77 65 6c 6c 2e 20 |t down a|s well. |
|00004dd0| 46 69 6e 61 6c 6c 79 2c | 20 69 66 20 63 4c 6f 63 |Finally,| if cLoc|
|00004de0| 6b 52 65 61 6c 41 72 65 | 61 28 29 20 68 61 73 20 |kRealAre|a() has |
|00004df0| 6d 61 64 65 20 69 74 20 | 74 68 69 73 20 66 61 72 |made it |this far|
|00004e00| 2c 20 63 4c 6f 63 6b 52 | 65 61 6c 41 72 65 61 28 |, cLockR|ealArea(|
|00004e10| 29 20 77 69 6c 6c 20 74 | 72 79 20 74 6f 20 69 6e |) will t|ry to in|
|00004e20| 73 65 72 74 20 74 68 65 | 20 41 64 64 72 4d 61 70 |sert the| AddrMap|
|00004e30| 20 65 6e 74 72 79 20 69 | 6e 74 6f 20 74 68 65 20 | entry i|nto the |
|00004e40| 6c 69 6e 6b 65 64 20 6c | 69 73 74 20 70 6f 69 6e |linked l|ist poin|
|00004e50| 74 65 64 20 74 6f 20 62 | 79 20 4d 61 70 50 74 72 |ted to b|y MapPtr|
|00004e60| 20 69 6e 20 74 68 65 20 | 69 63 63 6d 20 63 6f 6d | in the |iccm com|
|00004e70| 6d 75 6e 69 63 61 74 69 | 6f 6e 73 20 61 72 65 61 |municati|ons area|
|00004e80| 20 63 61 5f 52 65 63 2e | 20 63 4c 6f 63 6b 52 65 | ca_Rec.| cLockRe|
|00004e90| 61 6c 41 72 65 61 28 29 | 20 77 69 6c 6c 20 63 68 |alArea()| will ch|
|00004ea0| 61 6e 67 65 20 4d 61 70 | 43 68 6b 2c 20 69 6e 73 |ange Map|Chk, ins|
|00004eb0| 65 72 74 20 74 68 65 20 | 41 64 64 72 4d 61 70 20 |ert the |AddrMap |
|00004ec0| 65 6e 74 72 79 2c 20 61 | 6e 64 20 74 68 65 6e 20 |entry, a|nd then |
|00004ed0| 63 68 61 6e 67 65 20 4d | 61 70 43 6e 74 20 74 6f |change M|apCnt to|
|00004ee0| 20 62 65 20 74 68 65 20 | 73 61 6d 65 20 76 61 6c | be the |same val|
|00004ef0| 75 65 20 61 73 20 4d 61 | 70 43 68 6b 2e 0d 57 68 |ue as Ma|pChk..Wh|
|00004f00| 61 74 20 63 4e 65 74 43 | 6f 70 79 28 29 20 64 6f |at cNetC|opy() do|
|00004f10| 65 73 20 69 73 20 74 61 | 6b 65 20 61 73 20 69 6e |es is ta|ke as in|
|00004f20| 70 75 74 20 61 20 73 6f | 75 72 63 65 20 54 49 44 |put a so|urce TID|
|00004f30| 2f 73 6f 75 72 63 65 20 | 61 64 64 72 65 73 73 2c |/source |address,|
|00004f40| 20 64 65 73 74 69 6e 61 | 74 69 6f 6e 20 54 49 44 | destina|tion TID|
|00004f50| 2f 64 65 73 74 69 6e 61 | 74 69 6f 6e 20 61 64 64 |/destina|tion add|
|00004f60| 72 65 73 73 2c 20 61 6e | 64 20 73 69 7a 65 2e 20 |ress, an|d size. |
|00004f70| 63 4e 65 74 43 6f 70 79 | 28 29 20 63 61 6c 6c 73 |cNetCopy|() calls|
|00004f80| 20 63 56 69 72 74 75 61 | 6c 54 6f 52 65 61 6c 28 | cVirtua|lToReal(|
|00004f90| 29 20 74 6f 20 63 6f 6e | 76 65 72 74 20 74 68 65 |) to con|vert the|
|00004fa0| 20 73 6f 75 72 63 65 20 | 54 49 44 2f 73 6f 75 72 | source |TID/sour|
|00004fb0| 63 65 20 61 64 64 72 65 | 73 73 20 61 6e 64 20 74 |ce addre|ss and t|
|00004fc0| 68 65 20 64 65 73 74 69 | 6e 61 74 69 6f 6e 20 54 |he desti|nation T|
|00004fd0| 49 44 2f 64 65 73 74 69 | 6e 61 74 69 6f 6e 20 61 |ID/desti|nation a|
|00004fe0| 64 64 72 65 73 73 20 69 | 6e 74 6f 20 4e 75 42 75 |ddress i|nto NuBu|
|00004ff0| 73 20 61 64 64 72 65 73 | 73 65 73 2e 20 49 66 20 |s addres|ses. If |
|00005000| 63 56 69 72 74 75 61 6c | 54 6f 52 65 61 6c 28 29 |cVirtual|ToReal()|
|00005010| 20 63 61 6e 20 63 6f 6e | 76 65 72 74 20 74 68 65 | can con|vert the|
|00005020| 20 61 64 64 72 65 73 73 | 65 73 2c 20 63 4e 65 74 | address|es, cNet|
|00005030| 43 6f 70 79 28 29 20 77 | 69 6c 6c 20 70 65 72 66 |Copy() w|ill perf|
|00005040| 6f 72 6d 20 61 20 62 6c | 6f 63 6b 6d 6f 76 65 28 |orm a bl|ockmove(|
|00005050| 29 20 6f 70 65 72 61 74 | 69 6f 6e 20 6d 6f 76 69 |) operat|ion movi|
|00005060| 6e 67 20 74 68 65 20 64 | 61 74 61 20 69 74 73 65 |ng the d|ata itse|
|00005070| 6c 66 2e 20 49 66 20 63 | 56 69 72 74 75 61 6c 54 |lf. If c|VirtualT|
|00005080| 6f 52 65 61 6c 28 29 20 | 63 61 6e 6e 6f 74 20 63 |oReal() |cannot c|
|00005090| 6f 6e 76 65 72 74 20 74 | 68 65 20 61 64 64 72 65 |onvert t|he addre|
|000050a0| 73 73 65 73 2c 20 63 4e | 65 74 43 6f 70 79 28 29 |sses, cN|etCopy()|
|000050b0| 20 77 69 6c 6c 20 73 65 | 6e 64 20 61 6e 20 41 2f | will se|nd an A/|
|000050c0| 52 4f 53 45 20 49 50 43 | 20 6d 65 73 73 61 67 65 |ROSE IPC| message|
|000050d0| 20 74 6f 20 74 68 65 20 | 4e 75 42 75 73 20 73 6c | to the |NuBus sl|
|000050e0| 6f 74 20 28 70 6c 65 61 | 73 65 20 6e 6f 74 65 20 |ot (plea|se note |
|000050f0| 74 68 61 74 20 74 68 65 | 20 6d 61 69 6e 20 6c 6f |that the| main lo|
|00005100| 67 69 63 20 62 6f 61 72 | 64 20 69 73 20 4e 75 42 |gic boar|d is NuB|
|00005110| 75 73 20 73 6c 6f 74 20 | 7a 65 72 6f 29 20 61 73 |us slot |zero) as|
|00005120| 6b 69 6e 67 20 74 68 65 | 20 69 63 63 6d 20 28 70 |king the| iccm (p|
|00005130| 6c 65 61 73 65 20 6e 6f | 74 65 20 74 68 61 74 20 |lease no|te that |
|00005140| 69 63 63 6d 20 69 73 20 | 62 75 69 6c 74 20 69 6e |iccm is |built in|
|00005150| 74 6f 20 74 68 65 20 41 | 2f 52 4f 53 45 20 64 72 |to the A|/ROSE dr|
|00005160| 69 76 65 72 20 6f 6e 20 | 74 68 65 20 6d 61 69 6e |iver on |the main|
|00005170| 20 6c 6f 67 69 63 20 62 | 6f 61 72 64 29 20 74 6f | logic b|oard) to|
|00005180| 20 70 65 72 66 6f 72 6d | 20 74 68 65 20 63 6f 70 | perform| the cop|
|00005190| 79 2e 20 49 63 63 6d 20 | 77 69 6c 6c 20 70 65 72 |y. Iccm |will per|
|000051a0| 66 6f 72 6d 20 74 68 65 | 20 63 6f 70 79 20 61 6e |form the| copy an|
|000051b0| 64 20 73 65 6e 64 20 61 | 20 72 65 70 6c 79 20 62 |d send a| reply b|
|000051c0| 61 63 6b 20 74 6f 20 63 | 4e 65 74 43 6f 70 79 28 |ack to c|NetCopy(|
|000051d0| 29 20 77 68 65 6e 20 74 | 68 65 20 63 6f 70 79 20 |) when t|he copy |
|000051e0| 69 73 20 63 6f 6d 70 6c | 65 74 65 2e 0d 41 74 20 |is compl|ete..At |
|000051f0| 74 68 69 73 20 6d 6f 6d | 65 6e 74 2c 20 74 68 65 |this mom|ent, the|
|00005200| 20 6f 6e 6c 79 20 73 6c | 6f 74 20 74 68 61 74 20 | only sl|ot that |
|00005210| 63 61 6e 20 68 61 76 65 | 20 76 69 72 74 75 61 6c |can have| virtual|
|00005220| 20 61 64 64 72 65 73 73 | 65 73 20 74 68 61 74 20 | address|es that |
|00005230| 63 56 69 72 74 75 61 6c | 54 6f 52 65 61 6c 28 29 |cVirtual|ToReal()|
|00005240| 20 63 61 6e 6e 6f 74 20 | 63 6f 6e 76 65 72 74 20 | cannot |convert |
|00005250| 74 6f 20 4e 75 42 75 73 | 20 61 64 64 72 65 73 73 |to NuBus| address|
|00005260| 65 73 20 61 72 65 20 6d | 61 69 6e 20 6c 6f 67 69 |es are m|ain logi|
|00005270| 63 20 62 6f 61 72 64 20 | 61 64 64 72 65 73 73 65 |c board |addresse|
|00005280| 73 2e 20 63 56 69 72 74 | 75 61 6c 54 6f 52 65 61 |s. cVirt|ualToRea|
|00005290| 6c 28 29 20 63 61 6e 20 | 61 6c 77 61 79 73 20 72 |l() can |always r|
|000052a0| 65 73 6f 6c 76 65 20 76 | 69 72 74 75 61 6c 20 61 |esolve v|irtual a|
|000052b0| 64 64 72 65 73 73 65 73 | 20 74 68 61 74 20 65 78 |ddresses| that ex|
|000052c0| 69 73 74 20 6f 6e 20 4e | 75 42 75 73 20 63 61 72 |ist on N|uBus car|
|000052d0| 64 73 2e 0d 49 66 20 74 | 68 65 20 75 73 65 72 20 |ds..If t|he user |
|000052e0| 6f 6e 20 74 68 65 20 4d | 61 63 69 6e 74 6f 73 68 |on the M|acintosh|
|000052f0| 20 4f 70 65 72 61 74 69 | 6e 67 20 53 79 73 74 65 | Operati|ng Syste|
|00005300| 6d 20 73 69 64 65 20 64 | 6f 65 73 20 6e 6f 74 20 |m side d|oes not |
|00005310| 75 73 65 20 4c 6f 63 6b | 52 65 61 6c 41 72 65 61 |use Lock|RealArea|
|00005320| 28 29 20 61 6e 64 20 50 | 4d 4d 55 20 69 73 20 62 |() and P|MMU is b|
|00005330| 65 6c 69 65 76 65 64 20 | 74 6f 20 62 65 20 61 63 |elieved |to be ac|
|00005340| 74 69 76 65 2c 20 61 6e | 20 41 2f 52 4f 53 45 20 |tive, an| A/ROSE |
|00005350| 49 50 43 20 6d 65 73 73 | 61 67 65 20 69 73 20 73 |IPC mess|age is s|
|00005360| 65 6e 74 20 66 72 6f 6d | 20 74 68 65 20 4e 75 42 |ent from| the NuB|
|00005370| 75 73 20 63 61 72 64 20 | 74 6f 20 74 68 65 20 69 |us card |to the i|
|00005380| 63 63 6d 20 70 6f 72 74 | 69 6f 6e 20 6f 66 20 74 |ccm port|ion of t|
|00005390| 68 65 20 41 2f 52 4f 53 | 45 20 64 72 69 76 65 72 |he A/ROS|E driver|
|000053a0| 20 6f 6e 20 74 68 65 20 | 6d 61 69 6e 20 6c 6f 67 | on the |main log|
|000053b0| 69 63 20 62 6f 61 72 64 | 20 74 6f 20 70 65 72 66 |ic board| to perf|
|000053c0| 6f 72 6d 20 74 68 65 20 | 63 6f 70 79 2e 20 54 68 |orm the |copy. Th|
|000053d0| 65 20 69 63 63 6d 20 70 | 6f 72 74 69 6f 6e 20 6f |e iccm p|ortion o|
|000053e0| 66 20 74 68 65 20 41 2f | 52 4f 53 45 20 64 72 69 |f the A/|ROSE dri|
|000053f0| 76 65 72 20 77 69 6c 6c | 20 73 65 6e 64 20 62 61 |ver will| send ba|
|00005400| 63 6b 20 61 20 72 65 70 | 6c 79 20 77 68 65 6e 20 |ck a rep|ly when |
|00005410| 69 74 20 68 61 73 20 70 | 65 72 66 6f 72 6d 65 64 |it has p|erformed|
|00005420| 20 74 68 65 20 63 6f 70 | 79 2e 0d 4f 6e 65 20 75 | the cop|y..One u|
|00005430| 6e 61 73 6b 65 64 20 71 | 75 65 73 74 69 6f 6e 20 |nasked q|uestion |
|00005440| 69 73 20 63 6f 75 6c 64 | 20 74 68 65 20 63 61 72 |is could| the car|
|00005450| 64 20 72 65 71 75 65 73 | 74 20 74 68 61 74 20 6d |d reques|t that m|
|00005460| 65 6d 6f 72 79 20 6f 6e | 20 74 68 65 20 6d 61 69 |emory on| the mai|
|00005470| 6e 20 6c 6f 67 69 63 20 | 62 6f 61 72 64 20 62 65 |n logic |board be|
|00005480| 20 6c 6f 63 6b 65 64 20 | 64 6f 77 6e 20 66 72 6f | locked |down fro|
|00005490| 6d 20 74 68 65 20 63 61 | 72 64 2e 20 54 68 65 20 |m the ca|rd. The |
|000054a0| 61 6e 73 77 65 72 20 74 | 6f 20 74 68 69 73 20 71 |answer t|o this q|
|000054b0| 75 65 73 74 69 6f 6e 20 | 69 73 20 6e 6f 2e 20 54 |uestion |is no. T|
|000054c0| 68 65 20 4c 6f 63 6b 52 | 65 61 6c 41 72 65 61 28 |he LockR|ealArea(|
|000054d0| 29 20 72 6f 75 74 69 6e | 65 20 6f 6e 20 74 68 65 |) routin|e on the|
|000054e0| 20 6d 61 69 6e 20 6c 6f | 67 69 63 20 62 6f 61 72 | main lo|gic boar|
|000054f0| 64 20 74 68 61 74 20 64 | 6f 65 73 20 74 68 65 20 |d that d|oes the |
|00005500| 6c 6f 63 6b 69 6e 67 20 | 64 6f 77 6e 20 6f 66 20 |locking |down of |
|00005510| 6d 65 6d 6f 72 79 20 6f | 6e 20 74 68 65 20 6d 61 |memory o|n the ma|
|00005520| 69 6e 20 6c 6f 67 69 63 | 20 62 6f 61 72 64 20 61 |in logic| board a|
|00005530| 73 73 6f 63 69 61 74 65 | 73 20 74 68 65 20 6d 65 |ssociate|s the me|
|00005540| 6d 6f 72 79 20 74 68 61 | 74 20 69 74 20 69 73 20 |mory tha|t it is |
|00005550| 6c 6f 63 6b 69 6e 67 20 | 64 6f 77 6e 20 77 69 74 |locking |down wit|
|00005560| 68 20 74 68 65 20 54 49 | 44 20 6f 66 20 74 68 65 |h the TI|D of the|
|00005570| 20 6d 61 69 6e 20 6c 6f | 67 69 63 20 62 6f 61 72 | main lo|gic boar|
|00005580| 64 20 70 72 6f 63 65 73 | 73 20 74 68 61 74 20 69 |d proces|s that i|
|00005590| 73 20 63 61 6c 6c 69 6e | 67 20 4c 6f 63 6b 52 65 |s callin|g LockRe|
|000055a0| 61 6c 41 72 65 61 28 29 | 2e 0d 4e 75 42 75 73 20 |alArea()|..NuBus |
|000055b0| d5 39 30 20 61 6e 64 20 | 4d 43 50 20 63 61 72 64 |.90 and |MCP card|
|000055c0| 20 74 69 6d 69 6e 67 0d | 57 72 69 74 74 65 6e 3a | timing.|Written:|
|000055d0| 09 38 2f 32 38 2f 39 31 | 0d 4c 61 73 74 20 72 65 |.8/28/91|.Last re|
|000055e0| 76 69 65 77 65 64 3a 09 | 38 2f 31 39 2f 39 32 0d |viewed:.|8/19/92.|
|000055f0| 54 68 65 20 4d 61 63 69 | 6e 74 6f 73 68 20 43 6f |The Maci|ntosh Co|
|00005600| 70 72 6f 63 65 73 73 6f | 72 20 28 4d 43 50 29 20 |processo|r (MCP) |
|00005610| 63 61 72 64 20 75 73 65 | 73 20 74 68 65 20 4e 75 |card use|s the Nu|
|00005620| 42 75 73 20 31 30 20 4d | 48 7a 20 63 6c 6f 63 6b |Bus 10 M|Hz clock|
|00005630| 20 66 6f 72 20 74 68 65 | 20 73 79 73 74 65 6d 20 | for the| system |
|00005640| 63 6c 6f 63 6b 20 61 6e | 64 20 74 68 65 20 4e 75 |clock an|d the Nu|
|00005650| 42 75 73 d5 39 30 20 63 | 6c 6f 63 6b 20 69 73 20 |Bus.90 c|lock is |
|00005660| 32 30 20 4d 48 7a 2c 20 | 73 6f 20 68 6f 77 20 63 |20 MHz, |so how c|
|00005670| 61 6e 20 74 68 65 20 63 | 61 72 64 73 20 63 6f 6e |an the c|ards con|
|00005680| 74 69 6e 75 65 20 74 6f | 20 77 6f 72 6b 3f 20 54 |tinue to| work? T|
|00005690| 68 65 20 36 38 30 30 30 | 20 69 73 6e d5 74 20 72 |he 68000| isn.t r|
|000056a0| 61 74 65 64 20 66 6f 72 | 20 32 30 20 4d 48 7a 2e |ated for| 20 MHz.|
|000056b0| 20 49 73 20 74 68 65 72 | 65 20 61 20 6e 65 77 20 | Is ther|e a new |
|000056c0| 70 69 6e 6f 75 74 20 66 | 6f 72 20 4e 75 42 75 73 |pinout f|or NuBus|
|000056d0| d5 39 30 20 74 68 61 74 | 20 70 72 6f 76 69 64 65 |.90 that| provide|
|000056e0| 73 20 62 6f 74 68 20 63 | 6c 6f 63 6b 73 3f 0d 5f |s both c|locks?._|
|000056f0| 5f 5f 0d 54 68 65 20 4e | 75 42 75 73 d5 39 30 20 |__.The N|uBus.90 |
|00005700| 43 4c 4b 20 73 69 67 6e | 61 6c 20 28 70 69 6e 20 |CLK sign|al (pin |
|00005710| 43 33 32 29 20 69 73 20 | 31 30 20 4d 48 7a 20 28 |C32) is |10 MHz (|
|00005720| 64 69 64 6e d5 74 20 63 | 68 61 6e 67 65 29 3b 20 |didn.t c|hange); |
|00005730| 74 68 65 20 32 30 20 4d | 48 7a 20 63 6c 6f 63 6b |the 20 M|Hz clock|
|00005740| 20 73 69 67 6e 61 6c 20 | 69 73 20 74 68 65 20 43 | signal |is the C|
|00005750| 4c 4b 32 58 20 73 69 67 | 6e 61 6c 2c 20 77 68 69 |LK2X sig|nal, whi|
|00005760| 63 68 20 69 73 20 70 69 | 6e 20 42 32 34 20 28 70 |ch is pi|n B24 (p|
|00005770| 72 65 76 69 6f 75 73 6c | 79 20 2d 35 2e 32 20 56 |reviousl|y -5.2 V|
|00005780| 6f 6c 74 73 29 2e 0d 44 | 79 6e 61 6d 69 63 61 6c |olts)..D|ynamical|
|00005790| 6c 79 20 64 6f 77 6e 6c | 6f 61 64 65 64 20 41 2f |ly downl|oaded A/|
|000057a0| 52 4f 53 45 20 74 61 73 | 6b 20 73 70 65 63 69 66 |ROSE tas|k specif|
|000057b0| 69 63 61 74 69 6f 6e 73 | 0d 57 72 69 74 74 65 6e |ications|.Written|
|000057c0| 3a 09 32 2f 32 35 2f 39 | 32 0d 4c 61 73 74 20 72 |:.2/25/9|2.Last r|
|000057d0| 65 76 69 65 77 65 64 3a | 09 38 2f 31 39 2f 39 32 |eviewed:|.8/19/92|
|000057e0| 0d 48 6f 77 20 64 6f 65 | 73 20 61 20 64 79 6e 61 |.How doe|s a dyna|
|000057f0| 6d 69 63 61 6c 6c 79 20 | 64 6f 77 6e 6c 6f 61 64 |mically |download|
|00005800| 65 64 20 41 2f 52 4f 53 | 45 20 74 61 73 6b 20 73 |ed A/ROS|E task s|
|00005810| 70 65 63 69 66 79 20 69 | 74 73 20 73 74 61 63 6b |pecify i|ts stack|
|00005820| 20 73 69 7a 65 2c 20 68 | 65 61 70 20 73 69 7a 65 | size, h|eap size|
|00005830| 2c 20 65 78 65 63 75 74 | 69 6f 6e 20 70 72 69 6f |, execut|ion prio|
|00005840| 72 69 74 79 3f 0d 5f 5f | 5f 0d 59 6f 75 d5 6c 6c |rity?.__|_.You.ll|
|00005850| 20 6e 6f 74 65 20 66 72 | 6f 6d 20 74 68 65 20 64 | note fr|om the d|
|00005860| 65 73 63 72 69 70 74 69 | 6f 6e 20 6f 66 20 74 68 |escripti|on of th|
|00005870| 65 20 44 79 6e 61 6d 69 | 63 44 6f 77 6e 6c 6f 61 |e Dynami|cDownloa|
|00005880| 64 20 66 75 6e 63 74 69 | 6f 6e 20 61 73 20 64 65 |d functi|on as de|
|00005890| 73 63 72 69 62 65 64 20 | 69 6e 20 74 68 65 20 4d |scribed |in the M|
|000058a0| 61 63 69 6e 74 6f 73 68 | 20 43 6f 70 72 6f 63 65 |acintosh| Coproce|
|000058b0| 73 73 6f 72 20 50 6c 61 | 74 66 6f 72 6d 20 44 65 |ssor Pla|tform De|
|000058c0| 76 65 6c 6f 70 65 72 d5 | 73 20 47 75 69 64 65 2c |veloper.|s Guide,|
|000058d0| 20 70 61 67 65 20 38 2d | 38 2c 20 74 68 61 74 20 | page 8-|8, that |
|000058e0| 61 20 70 6f 69 6e 74 65 | 72 20 74 6f 20 61 6e 20 |a pointe|r to an |
|000058f0| 52 53 4d 5f 53 74 61 72 | 74 54 61 73 6b 20 70 61 |RSM_Star|tTask pa|
|00005900| 72 61 6d 65 74 65 72 20 | 61 72 65 61 20 69 73 20 |rameter |area is |
|00005910| 72 65 71 75 69 72 65 64 | 2e 20 54 68 65 20 63 61 |required|. The ca|
|00005920| 6c 6c 65 72 20 6d 75 73 | 74 20 69 6e 69 74 69 61 |ller mus|t initia|
|00005930| 6c 69 7a 65 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 |lize the| followi|
|00005940| 6e 67 20 66 69 65 6c 64 | 73 3a 0d 20 20 73 74 5f |ng field|s:.  st_|
|00005950| 70 61 72 6d 62 6c 6f 63 | 6b 2d 3e 73 74 61 63 6b |parmbloc|k->stack|
|00005960| 0d 20 20 73 74 5f 70 61 | 72 6d 62 6c 6f 63 6b 2d |.  st_pa|rmblock-|
|00005970| 3e 68 65 61 70 0d 20 20 | 73 74 5f 70 61 72 6d 62 |>heap.  |st_parmb|
|00005980| 6c 6f 63 6b 2d 3e 70 72 | 69 6f 72 69 74 79 0d 20 |lock->pr|iority. |
|00005990| 20 73 74 5f 70 61 72 6d | 62 6c 6f 63 6b 2d 3e 50 | st_parm|block->P|
|000059a0| 61 72 65 6e 74 54 49 44 | 0d 54 68 65 20 64 79 6e |arentTID|.The dyn|
|000059b0| 61 6d 69 63 20 64 6f 77 | 6e 6c 6f 61 64 20 70 72 |amic dow|nload pr|
|000059c0| 6f 63 65 73 73 20 75 73 | 65 73 20 74 68 65 73 65 |ocess us|es these|
|000059d0| 20 66 69 65 6c 64 73 20 | 6f 66 20 74 68 65 20 52 | fields |of the R|
|000059e0| 53 4d 20 28 52 65 6d 6f | 74 65 20 53 74 61 72 74 |SM (Remo|te Start|
|000059f0| 20 4d 61 6e 61 67 65 72 | 29 20 70 61 72 61 6d 65 | Manager|) parame|
|00005a00| 74 65 72 20 62 6c 6f 63 | 6b 20 77 68 65 6e 20 69 |ter bloc|k when i|
|00005a10| 6e 69 74 69 61 6c 69 7a | 69 6e 67 20 61 6e 20 41 |nitializ|ing an A|
|00005a20| 2f 52 4f 53 45 20 74 61 | 73 6b 2e 0d 44 79 6e 61 |/ROSE ta|sk..Dyna|
|00005a30| 6d 69 63 61 6c 6c 79 20 | 64 6f 77 6e 6c 6f 61 64 |mically |download|
|00005a40| 65 64 20 41 2f 52 4f 53 | 45 20 74 61 73 6b 20 73 |ed A/ROS|E task s|
|00005a50| 74 61 72 74 75 70 0d 57 | 72 69 74 74 65 6e 3a 09 |tartup.W|ritten:.|
|00005a60| 32 2f 32 35 2f 39 32 0d | 4c 61 73 74 20 72 65 76 |2/25/92.|Last rev|
|00005a70| 69 65 77 65 64 3a 09 38 | 2f 31 39 2f 39 32 0d 57 |iewed:.8|/19/92.W|
|00005a80| 68 65 6e 20 61 6e 20 41 | 2f 52 4f 53 45 20 74 61 |hen an A|/ROSE ta|
|00005a90| 73 6b 20 69 73 20 64 6f | 77 6e 6c 6f 61 64 65 64 |sk is do|wnloaded|
|00005aa0| 20 64 79 6e 61 6d 69 63 | 61 6c 6c 79 2c 20 68 6f | dynamic|ally, ho|
|00005ab0| 77 20 61 6e 64 20 77 68 | 65 6e 20 69 73 20 69 74 |w and wh|en is it|
|00005ac0| 20 73 74 61 72 74 65 64 | 20 75 70 3f 0d 5f 5f 5f | started| up?.___|
|00005ad0| 0d 54 68 65 20 71 75 69 | 63 6b 20 61 6e 73 77 65 |.The qui|ck answe|
|00005ae0| 72 20 69 73 20 74 68 61 | 74 20 73 75 63 68 20 61 |r is tha|t such a|
|00005af0| 20 74 61 73 6b 20 69 73 | 20 73 74 61 72 74 65 64 | task is| started|
|00005b00| 20 62 65 66 6f 72 65 20 | 74 68 65 20 64 6f 77 6e | before |the down|
|00005b10| 6c 6f 61 64 20 72 6f 75 | 74 69 6e 65 20 72 65 74 |load rou|tine ret|
|00005b20| 75 72 6e 73 2e 20 41 20 | 6d 6f 72 65 20 63 6f 6d |urns. A |more com|
|00005b30| 70 6c 65 74 65 20 61 6e | 73 77 65 72 20 63 61 6e |plete an|swer can|
|00005b40| 20 62 65 20 6d 61 64 65 | 20 62 79 20 70 65 72 75 | be made| by peru|
|00005b50| 73 69 6e 67 20 74 68 65 | 20 50 6f 72 74 61 62 6c |sing the| Portabl|
|00005b60| 65 20 41 2f 52 4f 53 45 | 20 63 6f 64 65 20 61 76 |e A/ROSE| code av|
|00005b70| 61 69 6c 61 62 6c 65 20 | 6f 6e 20 74 68 65 20 44 |ailable |on the D|
|00005b80| 65 76 65 6c 6f 70 65 72 | 20 43 44 2e 20 57 68 65 |eveloper| CD. Whe|
|00005b90| 6e 20 61 20 64 79 6e 61 | 6d 69 63 20 64 6f 77 6e |n a dyna|mic down|
|00005ba0| 6c 6f 61 64 20 63 61 6c | 6c 20 69 73 20 70 72 6f |load cal|l is pro|
|00005bb0| 63 65 73 73 65 64 2c 20 | 73 6f 6d 65 20 70 72 65 |cessed, |some pre|
|00005bc0| 66 6c 69 67 68 74 69 6e | 67 20 77 6f 72 6b 20 69 |flightin|g work i|
|00005bd0| 73 20 70 65 72 66 6f 72 | 6d 65 64 20 62 79 20 74 |s perfor|med by t|
|00005be0| 68 65 20 64 6f 77 6e 6c | 6f 61 64 20 72 6f 75 74 |he downl|oad rout|
|00005bf0| 69 6e 65 20 69 6e 20 74 | 68 65 20 41 2f 52 4f 53 |ine in t|he A/ROS|
|00005c00| 45 20 50 72 65 70 20 66 | 69 6c 65 2e 20 41 2f 52 |E Prep f|ile. A/R|
|00005c10| 4f 53 45 20 66 69 72 73 | 74 20 63 68 65 63 6b 73 |OSE firs|t checks|
|00005c20| 20 74 68 61 74 20 61 20 | 63 61 72 64 20 63 61 70 | that a |card cap|
|00005c30| 61 62 6c 65 20 6f 66 20 | 72 75 6e 6e 69 6e 67 20 |able of |running |
|00005c40| 41 2f 52 4f 53 45 20 65 | 78 69 73 74 73 20 69 6e |A/ROSE e|xists in|
|00005c50| 20 74 68 65 20 64 65 73 | 69 67 6e 61 74 65 64 20 | the des|ignated |
|00005c60| 73 6c 6f 74 2e 0d 41 2f | 52 4f 53 45 20 74 68 65 |slot..A/|ROSE the|
|00005c70| 6e 20 63 68 65 63 6b 73 | 20 76 69 61 20 74 68 65 |n checks| via the|
|00005c80| 20 52 65 6d 6f 74 65 20 | 53 79 73 74 65 6d 20 4d | Remote |System M|
|00005c90| 61 6e 61 67 65 72 20 28 | 52 53 4d 29 20 74 6f 20 |anager (|RSM) to |
|00005ca0| 64 65 74 65 72 6d 69 6e | 65 20 69 66 20 74 68 65 |determin|e if the|
|00005cb0| 72 65 20 69 73 20 73 75 | 66 66 69 63 69 65 6e 74 |re is su|fficient|
|00005cc0| 20 6d 65 6d 6f 72 79 20 | 6f 6e 20 74 68 65 20 74 | memory |on the t|
|00005cd0| 61 72 67 65 74 20 62 6f | 61 72 64 20 74 6f 20 70 |arget bo|ard to p|
|00005ce0| 72 6f 63 65 73 73 20 74 | 68 65 20 64 6f 77 6e 6c |rocess t|he downl|
|00005cf0| 6f 61 64 2e 20 54 68 65 | 20 6d 65 6d 6f 72 79 20 |oad. The| memory |
|00005d00| 69 73 20 61 6c 6c 6f 63 | 61 74 65 64 20 76 69 61 |is alloc|ated via|
|00005d10| 20 52 53 4d 20 66 6f 72 | 20 74 68 65 20 6e 65 77 | RSM for| the new|
|00005d20| 20 74 61 73 6b 2c 20 61 | 6e 64 20 61 20 63 6f 70 | task, a|nd a cop|
|00005d30| 79 20 6f 66 20 74 68 65 | 20 53 54 5f 50 42 20 69 |y of the| ST_PB i|
|00005d40| 73 20 6d 61 64 65 20 69 | 6e 74 6f 20 74 68 65 20 |s made i|nto the |
|00005d50| 75 73 65 72 20 61 72 65 | 61 2c 20 66 6f 72 20 70 |user are|a, for p|
|00005d60| 72 6f 63 65 73 73 69 6e | 67 20 74 68 65 20 64 6f |rocessin|g the do|
|00005d70| 77 6e 6c 6f 61 64 2e 20 | 54 68 65 20 72 65 67 69 |wnload. |The regi|
|00005d80| 73 74 65 72 20 62 6c 6f | 63 6b 73 20 61 72 65 20 |ster blo|cks are |
|00005d90| 74 68 65 6e 20 69 6e 69 | 74 69 61 6c 69 7a 65 64 |then ini|tialized|
|00005da0| 2e 20 41 20 6d 65 73 73 | 61 67 65 20 69 73 20 73 |. A mess|age is s|
|00005db0| 65 6e 74 20 74 6f 20 52 | 53 4d 20 74 6f 20 70 65 |ent to R|SM to pe|
|00005dc0| 72 66 6f 72 6d 20 74 68 | 65 20 52 53 4d 5f 53 74 |rform th|e RSM_St|
|00005dd0| 61 72 74 54 61 73 6b 20 | 70 72 6f 63 65 64 75 72 |artTask |procedur|
|00005de0| 65 2e 20 57 68 65 6e 20 | 52 53 4d 20 70 72 6f 63 |e. When |RSM proc|
|00005df0| 65 73 73 65 73 20 74 68 | 65 20 6d 65 73 73 61 67 |esses th|e messag|
|00005e00| 65 2c 20 61 20 63 61 6c | 6c 20 69 73 20 6d 61 64 |e, a cal|l is mad|
|00005e10| 65 20 74 6f 20 4e 65 74 | 43 6f 70 79 20 74 6f 20 |e to Net|Copy to |
|00005e20| 63 6f 70 79 20 74 68 65 | 20 53 54 5f 50 42 20 72 |copy the| ST_PB r|
|00005e30| 65 63 6f 72 64 20 6f 6e | 74 6f 20 74 68 65 20 63 |ecord on|to the c|
|00005e40| 61 72 64 2e 20 54 68 65 | 72 65 d5 73 20 73 6f 6d |ard. The|re.s som|
|00005e50| 65 20 6d 6f 72 65 20 70 | 72 65 66 6c 69 67 68 74 |e more p|reflight|
|00005e60| 69 6e 67 20 6f 66 20 74 | 68 65 20 53 54 5f 50 42 |ing of t|he ST_PB|
|00005e70| 2c 20 77 68 69 63 68 20 | 72 65 73 75 6c 74 73 20 |, which |results |
|00005e80| 69 6e 20 61 20 63 61 6c | 6c 20 74 6f 20 74 68 65 |in a cal|l to the|
|00005e90| 20 53 74 61 72 74 54 61 | 73 6b 20 49 6e 73 74 72 | StartTa|sk Instr|
|00005ea0| 75 63 74 69 6f 6e 20 54 | 72 61 70 2e 20 53 74 61 |uction T|rap. Sta|
|00005eb0| 72 74 54 61 73 6b 2c 20 | 61 73 20 73 68 6f 77 6e |rtTask, |as shown|
|00005ec0| 20 69 6e 20 74 68 65 20 | 66 69 6c 65 20 6f 73 74 | in the |file ost|
|00005ed0| 72 61 70 2e 61 20 66 72 | 6f 6d 20 50 6f 72 74 61 |rap.a fr|om Porta|
|00005ee0| 62 6c 65 20 41 2f 52 4f | 53 45 2c 20 65 6e 73 75 |ble A/RO|SE, ensu|
|00005ef0| 72 65 73 20 74 68 61 74 | 20 74 68 65 20 63 61 6c |res that| the cal|
|00005f00| 6c 20 64 69 64 20 6e 6f | 74 20 6f 72 69 67 69 6e |l did no|t origin|
|00005f10| 61 74 65 20 66 72 6f 6d | 20 61 6e 20 69 6e 74 65 |ate from| an inte|
|00005f20| 72 72 75 70 74 2e 20 54 | 68 65 20 74 61 73 6b 20 |rrupt. T|he task |
|00005f30| 74 61 62 6c 65 20 69 73 | 20 73 65 61 72 63 68 65 |table is| searche|
|00005f40| 64 20 66 6f 72 20 61 6e | 20 61 76 61 69 6c 61 62 |d for an| availab|
|00005f50| 6c 65 20 65 6e 74 72 79 | 2e 20 57 68 65 6e 20 6f |le entry|. When o|
|00005f60| 6e 65 20 69 73 20 66 6f | 75 6e 64 2c 20 6d 65 6d |ne is fo|und, mem|
|00005f70| 6f 72 79 20 69 73 20 61 | 6c 6c 6f 63 61 74 65 64 |ory is a|llocated|
|00005f80| 20 66 6f 72 20 74 68 65 | 20 70 72 6f 63 65 73 73 | for the| process|
|00005f90| 2c 20 68 65 61 70 2c 20 | 61 6e 64 20 73 74 61 63 |, heap, |and stac|
|00005fa0| 6b 20 69 66 20 73 70 65 | 63 69 66 69 65 64 2e 20 |k if spe|cified. |
|00005fb0| 53 6f 6d 65 20 61 64 64 | 69 74 69 6f 6e 61 6c 20 |Some add|itional |
|00005fc0| 70 72 6f 63 65 73 73 69 | 6e 67 20 69 73 20 70 65 |processi|ng is pe|
|00005fd0| 72 66 6f 72 6d 65 64 20 | 74 6f 20 73 65 74 20 75 |rformed |to set u|
|00005fe0| 70 20 74 68 65 20 74 61 | 73 6b 2e 20 46 69 6e 61 |p the ta|sk. Fina|
|00005ff0| 6c 6c 79 2c 20 74 68 65 | 20 74 61 73 6b 20 69 73 |lly, the| task is|
|00006000| 20 6c 69 6e 6b 65 64 20 | 69 6e 74 6f 20 61 20 70 | linked |into a p|
|00006010| 72 69 6f 72 69 74 79 20 | 74 61 62 6c 65 20 61 6e |riority |table an|
|00006020| 64 20 74 68 65 20 74 61 | 73 6b 20 62 65 63 6f 6d |d the ta|sk becom|
|00006030| 65 73 20 d2 6c 69 76 65 | 2e d3 0d 41 73 20 64 6f |es .live|...As do|
|00006040| 63 75 6d 65 6e 74 65 64 | 2c 20 74 68 65 20 64 6f |cumented|, the do|
|00006050| 77 6e 6c 6f 61 64 20 70 | 72 6f 63 65 73 73 20 72 |wnload p|rocess r|
|00006060| 65 74 75 72 6e 73 20 74 | 68 65 20 54 49 44 20 6f |eturns t|he TID o|
|00006070| 66 20 74 68 65 20 74 61 | 73 6b 2c 20 69 66 20 73 |f the ta|sk, if s|
|00006080| 75 63 63 65 73 73 66 75 | 6c 2e 20 49 74 20 73 68 |uccessfu|l. It sh|
|00006090| 6f 75 6c 64 20 62 65 20 | 6e 6f 74 65 64 20 74 68 |ould be |noted th|
|000060a0| 61 74 20 77 68 69 6c 65 | 20 74 68 65 20 74 61 73 |at while| the tas|
|000060b0| 6b 20 68 61 73 20 62 65 | 65 6e 20 73 74 61 72 74 |k has be|en start|
|000060c0| 65 64 2c 20 74 68 65 20 | 74 61 73 6b 20 73 74 69 |ed, the |task sti|
|000060d0| 6c 6c 20 6e 65 65 64 73 | 20 74 69 6d 65 20 74 6f |ll needs| time to|
|000060e0| 20 70 65 72 66 6f 72 6d | 20 69 6e 69 74 69 61 6c | perform| initial|
|000060f0| 69 7a 61 74 69 6f 6e 20 | 61 6e 64 20 61 6e 79 20 |ization |and any |
|00006100| 4e 61 6d 65 20 4d 61 6e | 61 67 65 72 20 72 65 67 |Name Man|ager reg|
|00006110| 69 73 74 72 61 74 69 6f | 6e 20 62 65 66 6f 72 65 |istratio|n before|
|00006120| 20 61 20 4c 6f 6f 6b 75 | 70 20 54 61 73 6b 20 63 | a Looku|p Task c|
|00006130| 61 6c 6c 20 69 73 20 6d | 61 64 65 2e 0d 54 68 65 |all is m|ade..The|
|00006140| 20 63 6f 64 65 20 61 76 | 61 69 6c 61 62 6c 65 20 | code av|ailable |
|00006150| 6f 6e 20 74 68 65 20 50 | 6f 72 74 61 62 6c 65 20 |on the P|ortable |
|00006160| 41 2f 52 4f 53 45 20 64 | 69 73 6b 20 69 73 20 61 |A/ROSE d|isk is a|
|00006170| 20 67 6f 6f 64 20 73 6f | 75 72 63 65 20 66 6f 72 | good so|urce for|
|00006180| 20 6c 65 61 72 6e 69 6e | 67 20 74 68 65 20 64 65 | learnin|g the de|
|00006190| 74 61 69 6c 73 20 6f 6e | 20 74 68 69 73 20 66 75 |tails on| this fu|
|000061a0| 6e 63 74 69 6f 6e 2e 0d | 46 72 65 65 4d 65 6d 20 |nction..|FreeMem |
|000061b0| 61 6e 64 20 46 72 65 65 | 4d 73 67 20 64 6f 6e d5 |and Free|Msg don.|
|000061c0| 74 20 73 65 74 20 70 6f | 69 6e 74 65 72 73 20 74 |t set po|inters t|
|000061d0| 6f 20 7a 65 72 6f 0d 57 | 72 69 74 74 65 6e 3a 09 |o zero.W|ritten:.|
|000061e0| 32 2f 32 35 2f 39 32 0d | 4c 61 73 74 20 72 65 76 |2/25/92.|Last rev|
|000061f0| 69 65 77 65 64 3a 09 38 | 2f 31 39 2f 39 32 0d 44 |iewed:.8|/19/92.D|
|00006200| 6f 20 74 68 65 20 41 2f | 52 4f 53 45 20 66 75 6e |o the A/|ROSE fun|
|00006210| 63 74 69 6f 6e 73 20 46 | 72 65 65 4d 65 6d 20 61 |ctions F|reeMem a|
|00006220| 6e 64 20 46 72 65 65 4d | 73 67 20 73 65 74 20 74 |nd FreeM|sg set t|
|00006230| 68 65 20 70 6f 69 6e 74 | 65 72 73 20 74 6f 20 7a |he point|ers to z|
|00006240| 65 72 6f 20 6f 72 20 64 | 6f 65 73 20 61 6e 20 41 |ero or d|oes an A|
|00006250| 2f 52 4f 53 45 20 74 61 | 73 6b 20 63 61 6c 6c 69 |/ROSE ta|sk calli|
|00006260| 6e 67 20 74 68 65 73 65 | 20 66 75 6e 63 74 69 6f |ng these| functio|
|00006270| 6e 73 20 68 61 76 65 20 | 74 6f 20 64 6f 20 73 6f |ns have |to do so|
|00006280| 20 65 78 70 6c 69 63 69 | 74 6c 79 3f 0d 5f 5f 5f | explici|tly?.___|
|00006290| 0d 46 72 65 65 4d 65 6d | 20 61 6e 64 20 46 72 65 |.FreeMem| and Fre|
|000062a0| 65 4d 73 67 20 64 6f 20 | 6e 6f 74 20 73 65 74 20 |eMsg do |not set |
|000062b0| 74 68 65 20 70 6f 69 6e | 74 65 72 73 20 74 6f 20 |the poin|ters to |
|000062c0| 7a 65 72 6f 20 75 70 6f | 6e 20 72 65 74 75 72 6e |zero upo|n return|
|000062d0| 2e 20 59 6f 75 72 20 70 | 72 6f 63 65 73 73 20 6d |. Your p|rocess m|
|000062e0| 75 73 74 20 64 6f 20 73 | 6f 20 65 78 70 6c 69 63 |ust do s|o explic|
|000062f0| 69 74 6c 79 20 69 66 20 | 79 6f 75 20 70 6c 61 6e |itly if |you plan|
|00006300| 20 74 6f 20 63 68 65 63 | 6b 20 77 68 65 74 68 65 | to chec|k whethe|
|00006310| 72 20 61 20 6d 65 73 73 | 61 67 65 20 62 6c 6f 63 |r a mess|age bloc|
|00006320| 6b 20 69 73 20 76 61 6c | 69 64 2e 0d 4e 65 74 5f |k is val|id..Net_|
|00006330| 52 65 67 69 73 74 65 72 | 5f 54 61 73 6b 20 73 61 |Register|_Task sa|
|00006340| 6d 65 20 61 73 20 52 65 | 67 69 73 74 65 72 5f 54 |me as Re|gister_T|
|00006350| 61 73 6b 28 2e 2e 2e 2c | 20 57 6f 72 6c 64 5f 56 |ask(...,| World_V|
|00006360| 69 73 69 62 6c 65 29 0d | 57 72 69 74 74 65 6e 3a |isible).|Written:|
|00006370| 09 32 2f 32 35 2f 39 32 | 0d 4c 61 73 74 20 72 65 |.2/25/92|.Last re|
|00006380| 76 69 65 77 65 64 3a 09 | 38 2f 31 39 2f 39 32 0d |viewed:.|8/19/92.|
|00006390| 57 68 61 74 d5 73 20 74 | 68 65 20 64 69 66 66 65 |What.s t|he diffe|
|000063a0| 72 65 6e 63 65 20 62 65 | 74 77 65 65 6e 20 74 68 |rence be|tween th|
|000063b0| 65 20 41 2f 52 4f 53 45 | 20 4e 65 74 5f 52 65 67 |e A/ROSE| Net_Reg|
|000063c0| 69 73 74 65 72 5f 54 61 | 73 6b 20 61 6e 64 20 52 |ister_Ta|sk and R|
|000063d0| 65 67 69 73 74 65 72 5f | 54 61 73 6b 28 2e 2e 2e |egister_|Task(...|
|000063e0| 2c 20 57 6f 72 6c 64 5f | 56 69 73 69 62 6c 65 29 |, World_|Visible)|
|000063f0| 3f 0d 5f 5f 5f 0d 54 68 | 65 72 65 d5 73 20 6e 6f |?.___.Th|ere.s no|
+--------+-------------------------+-------------------------+--------+--------+